MacOS通过Brew安装Python@3.9后无法识别site-packages内模块问题

问题核心是Python运行时的模块搜索路径sys.path和pip实际安装的路径不匹配：

• sys.path中列出的第三方包搜索路径为 /usr/local/lib/python3.9/site-packages
• 手动安装的pip实际存放在 /usr/local/Cellar/python@3.9/3.9.6/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages
  Python搜索模块时不会遍历到后者路径，因此提示找不到pip模块。

方案1：修复brew链接异常（优先推荐） #

该问题通常是brew安装Python时软链接配置错误导致，执行以下命令重置链接即可：

brew unlink python@3.9 && brew link python@3.9 --overwrite

执行完成后执行 python3 -m pip --version 验证是否恢复正常。

方案2：将pip安装到默认搜索路径 #

重新运行get-pip.py，指定安装到sys.path能识别的路径：

python3 get-pip.py --target=/usr/local/lib/python3.9/site-packages

安装完成后即可正常调用pip。

方案3：修改环境变量补全搜索路径 #

编辑你当前使用的shell配置文件（zsh为~/.zshrc，bash为~/.bash_profile），添加以下内容：

export PYTHONPATH="/usr/local/Cellar/python@3.9/3.9.6/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages:$PYTHONPATH"

保存后执行 source ~/.zshrc（或对应配置文件）使配置生效，即可正常使用pip。

临时使用方案 #

如果只是临时需要调用pip，直接使用绝对路径即可：

/usr/local/Cellar/python@3.9/3.9.6/Frameworks/Python.framework/Versions/3.9/bin/pip [你的命令]

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