# ModuleNotFoundError：没有名为 'pkg_resources' 的模块

- **ID:** `python/pkg-resources-missing`
- **领域:** python
- **类别:** module_error
- **验证级别:** ai_generated
- **修复率:** 80%

## 根因

当前环境中未安装 setuptools，或环境创建时未包含 setuptools（例如某些 venv 配置或未安装 pip 的发行版 Python）。导入 pkg_resources 的代码因此失败。

## 版本兼容性

| 版本 | 状态 | 引入 | 弃用 |
|------|------|------|------|
| 3.x | active | — | — |

## 解决方案

1. **** (95% 成功率)
   ```
   Install setuptools into the active environment:
python -m pip install setuptools
   ```
2. **** (85% 成功率)
   ```
   Migrate to importlib.metadata / importlib.resources:
from importlib.metadata import version
print(version('requests'))
   ```

## 无效尝试

- **** — There is no standalone pkg_resources package on PyPI; it ships inside setuptools. (95% 失败率)
- **** — Silences the error but any code depending on resource access still fails later. (70% 失败率)