客户MacOS缺失依赖项：安装Python后zsh无法识别求助

第一步：确认Python安装路径 #

官网的universal2安装包默认将Python安装到：
/Library/Frameworks/Python.framework/Versions/3.11/bin/

先在终端执行以下命令验证路径存在：

ls /Library/Frameworks/Python.framework/Versions/3.11/bin/

如果能看到python3、pip3等文件，说明Python本身安装正常。

第二步：临时验证Python可执行性 #

直接用完整路径运行Python，确认程序没问题：

/Library/Frameworks/Python.framework/Versions/3.11/bin/python3 --version

如果输出Python 3.11.8，说明安装包本身没问题，问题出在PATH配置。

第三步：正确配置zsh的PATH #

MacOS默认shell是zsh，配置文件为~/.zshrc，按以下步骤操作：

1. 编辑配置文件：

nano ~/.zshrc

2. 在文件末尾添加一行：

export PATH="/Library/Frameworks/Python.framework/Versions/3.11/bin:$PATH"

3. 保存并退出nano（按Ctrl+O，回车，再按Ctrl+X）
4. 让配置立即生效：

source ~/.zshrc

第四步：验证配置生效 #

执行以下命令检查：

which python3

如果输出/Library/Frameworks/Python.framework/Versions/3.11/bin/python3，再执行：

python3 --version

能正常显示版本号就说明问题解决。

可选：设置python别名（替代python3） #

如果需要用python命令直接调用3.11版本，创建软链接：

ln -s /Library/Frameworks/Python.framework/Versions/3.11/bin/python3 /Library/Frameworks/Python.framework/Versions/3.11/bin/python

执行后，终端输入python --version也会显示3.11.8。

额外提醒 #

官网安装包完成后，记得执行安装器里的「Install Certificates」选项，否则后续使用pip安装包可能出现SSL证书错误。

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