Python No module named pkg_resources及setuptools安装权限报错求助

你遇到的No module named pkg_resources报错本质是全局Python环境的setuptools组件损坏丢失——pkg_resources是setuptools的内置模块，它损坏后会连带pip无法正常运行。之前手动安装setuptools失败是因为你使用的Python安装在系统级目录，普通账号没有site-packages目录的写入权限，按以下操作即可修复：

• 下载pip官方安装引导脚本到本地。
• 打开终端，执行以下命令，用你报错路径对应的Python 3.8解释器以管理员权限运行引导脚本，脚本会自动安装版本匹配的pip和setuptools，补全所有缺失依赖：

sudo /Library/Frameworks/Python.framework/Versions/3.8/bin/python3 get-pip.py

执行命令后输入本机开机密码即可，输入密码过程中终端不会显示输入的字符，属于正常安全机制，输完直接按回车确认。

• 脚本执行完成后，运行以下命令验证修复结果：

pip3 --version

如果终端正常输出pip的版本号、对应安装路径，就说明修复完成，后续可正常使用pip安装各类依赖包。

避坑提示 #

• 执行修复前先在终端运行which python3，确认当前默认调用的Python路径和报错信息里的Python 3.8路径一致，避免把依赖装到其他Python环境导致修复无效。
• 报错里附带的setuptools文档链接无法访问是官方文档域名迁移导致的，无需尝试访问该链接。
• 日常开发建议使用虚拟环境做项目依赖隔离，不要随意修改全局Python环境的依赖包，避免再次出现组件损坏、依赖冲突的问题。

内容的提问来源于stack exchange，提问作者Megan