Mac Monterey安装Python3.12.1后python命令失效及pip相关问题求助

1. python命令找不到的修复 #

Mac Monterey 12.3.1默认未将python命令映射到Python 3，可通过以下两种方式解决：

• 添加Shell别名
  临时生效（仅当前终端会话）：

  alias python='python3'
  

  永久生效：编辑~/.zshrc文件，加入上述别名后执行：

  source ~/.zshrc
  

• 创建系统级软链接
  用sudo权限建立python指向python3的软链接：

  sudo ln -s /Library/Frameworks/Python.framework/Versions/3.12/bin/python3 /usr/local/bin/python
  

  验证：执行python -V应返回3.12.1版本。

2. pip找不到pkg-config的修复 #

pkg-config是Mac默认未预装的依赖管理工具，必须手动安装：

• Homebrew安装（推荐）
  若已安装Homebrew，直接运行：

  brew install pkg-config
  

  安装后pkg-config会被放入/usr/local/bin（Intel芯片）或/opt/homebrew/bin（Apple芯片），你的$PATH已包含/usr/local/bin，pip可自动识别该工具。

• 手动编译安装
  下载pkg-config源码包，编译后将生成的可执行文件移至/usr/local/bin目录。

额外清理建议 #

多次重复安装Python可能引发版本冲突，可做如下清理：

• 删除/Library/Frameworks/Python.framework/Versions/目录下除3.12以外的版本文件夹
• 编辑~/.zshrc，移除$PATH中冗余的/usr/local/bin/python3路径

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