macOS Big Sur下brew装Python3.9.4已装pip仍提示No module named pip求助

问题背景 #

• 当前运行系统为 macOS 11.2.2 Big Sur
• 目标是为 Homebrew 安装的 Python 3.9.4 配置可正常调用的 pip，清理多年使用积累的残留配置，把 Python 与 pip 环境恢复正常
• 额外遇到 pyenv 安装 Python 3.9.4 时构建失败的问题

已核对的当前环境状态 #

• 执行命令/usr/local/opt/python/bin/python3 --version，可正常返回 Homebrew 渠道安装的 Python 3.9.4；该路径为软链接，实际指向../Frameworks/Python.framework/Versions/3.9/bin/python3，对应文件存储在 Homebrew Cellar 目录下
• 已为python与python3配置别名，指向上述 Python 3.9.4 路径，执行后可正确返回版本号
• 先后通过官方 get-pip.py 脚本、Python 内置 ensurepip 工具安装 pip，两次操作均返回安装成功提示：Successfully installed pip-21.1.1 setuptools-56.0.0
• 环境变量中与 Python 相关的配置为 PATH 包含路径/usr/local/opt/python@3.9/Frameworks/Python.framework/Versions/3.9/bin，未配置该路径时 pip 安装流程会触发对应警告

现存异常表现 #

执行命令python -m pip --version时，系统返回如下错误：

/usr/local/opt/python@3.9/bin/python3.9: No module named pip

分步修复操作 #

1. 排查并修复 pip 与 Python 解释器的路径错位 #

出现安装成功但模块无法识别的情况，多为 pip 与解释器路径错位 导致——pip 被安装到了其他版本 Python 的 site-packages 目录下，没有匹配到当前实际运行的 Python 3.9.4 的模块搜索路径：

• 执行/usr/local/opt/python/bin/python3 -c "import sys; print('\n'.join(sys.path))"，打印当前 Python 实际搜索模块的所有路径，确认是否包含 Python 3.9.4 对应的 site-packages 目录
• 清除所有历史残留的 pip 安装文件，避免旧版本引发冲突：
  • 执行rm -rf /usr/local/lib/python3.9/site-packages/pip*
  • 执行rm -rf /Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/pip*
• 用指定的 Python 解释器强制重装 pip，确保安装路径完全匹配当前解释器：
  • 下载官方 get-pip.py 脚本到临时目录
  • 执行/usr/local/opt/python/bin/python3 get-pip.py --force-reinstall

2. 校正环境变量与软链接优先级 #

• 检查 PATH 变量的排序，确保 Homebrew 安装的 Python 路径排在系统自带 Python、其他版本 Python 路径之前，避免误调用其他版本的解释器
• 执行ls -l /usr/local/bin/python*检查所有相关软链接的指向，移除指向非 3.9.4 版本的无效残留软链接
• 确认 shell 配置文件中的别名没有指向错误路径，避免别名与实际解释器版本脱节

3. 解决 pyenv 安装 Python 3.9.4 构建失败问题 #

• 先执行xcode-select --install，确保 Xcode 命令行工具为与当前 macOS 版本匹配的最新版本
• 通过 Homebrew 安装 Python 构建所需的依赖组件：openssl readline sqlite3 xz zlib tcl-tk
• 安装前临时配置编译依赖的路径环境变量：

  export LDFLAGS="-L/usr/local/opt/openssl@1.1/lib -L/usr/local/opt/readline/lib -L/usr/local/opt/sqlite3/lib -L/usr/local/opt/zlib/lib -L/usr/local/opt/tcl-tk/lib"
  export CPPFLAGS="-I/usr/local/opt/openssl@1.1/include -I/usr/local/opt/readline/include -I/usr/local/opt/sqlite3/include -I/usr/local/opt/zlib/include -I/usr/local/opt/tcl-tk/include"
  

• 完成上述配置后执行pyenv install 3.9.4，即可正常完成版本构建

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