升级setuptools及执行setup.py命令时出错，求排查原因

API 探路者

2026-6-19

问题分析与解决办法

这个错误是因为你的setuptools安装文件已损坏，具体是pkg_resources的测试数据文件丢失，导致升级时无法完成文件校验。下面是具体的解决步骤：

清理损坏的setuptools残留
手动删除错误路径里提到的损坏目录，以及整个setuptools相关的文件夹：
找到路径 C:\Users\Administrator\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.12_qbz5n2kfra8p0\LocalCache\local-packages\Python312\site-packages，删除其中的setuptools和pkg_resources文件夹。
用ensurepip强制重装依赖
运行Python自带的ensurepip工具，彻底修复pip和setuptools：
```
python3 -m ensurepip --upgrade
```
这个命令会绕过现有损坏的文件，重新安装完整的pip和setuptools包。
替换旧的setup.py命令（推荐）
官方已弃用直接运行python setup.py sdist bdist_wheel的方式，改用build模块更稳定：
1. 先安装build：
```
pip install build
```
2. 在setup.py所在目录执行：
```
python -m build
```
这个工具会自动处理依赖，避免手动调用setup.py带来的环境问题。
修复Python安装（终极方案）
如果以上方法都无效，说明Python安装本身可能有损坏。打开Windows设置→应用→找到Python 3.12→点击“修改”→选择“修复”，让安装程序自动修复缺失或损坏的系统文件。