# pkg_resources.VersionConflict: (importlib-metadata 4.0.0 (/usr/lib/python3/dist-packages), Requirement.parse('importlib-metadata>=4.6.4'))

- **ID:** `python/importlib-metadata-version-conflict`
- **领域:** python
- **类别:** module_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

系统（发行版）管理的 importlib-metadata 版本低于某个包的要求，pkg_resources 因已安装版本不满足要求而拒绝继续。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.8 | active | — | — |
| 3.9 | active | — | — |
| 3.10 | active | — | — |

## 解决方案

1. **** (90% 成功率)
   ```
   Use a virtualenv so pip's importlib-metadata shadows the system one: `python -m venv .venv && . .venv/bin/activate && pip install -U importlib-metadata`.
   ```
2. **** (75% 成功率)
   ```
   Upgrade in user space: `pip install --user -U 'importlib-metadata>=4.6.4'` and ensure `~/.local/lib` precedes `/usr/lib/python3/dist-packages` on sys.path.
   ```

## 无效尝试

- **** — Leaves two copies on sys.path and the distro copy may still shadow the new one. (60% 失败率)
- **** — Breaks other system tools that depend on it. (70% 失败率)