VS Code无法运行Python代码：zsh找不到python命令求助

1. 是否多次安装了Python？ #

是的，你系统里存在至少两个不同来源的Python：

• 全局环境的Python 3.10：路径为/Library/Frameworks/Python.framework/Versions/3.10/bin/python3，属于官方框架或第三方安装包部署的版本；
• Conda虚拟环境的Python：路径为/opt/homebrew/Caskroom/miniforge/base/envs/tensorflow/bin/python，是通过Homebrew安装的miniforge（Conda分支）创建的tensorflow虚拟环境专属版本。

2. VS Code无法识别python命令的原因 #

• macOS从Big Sur版本开始，默认不再提供python命令（仅保留python3），你的全局环境未配置python到python3的别名，导致直接调用python会报错；
• VS Code默认可能使用全局环境的Python解释器，未自动关联到你创建的tensorflow虚拟环境，因此无法找到对应命令。

3. 修复步骤 #

方法一：全局配置python别名（解决终端和VS Code全局调用问题） #

1. 打开终端，编辑zsh配置文件：

   nano ~/.zshrc
   

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

   alias python='python3'
   

3. 保存并退出（按Ctrl+O回车，再按Ctrl+X），然后使配置生效：

   source ~/.zshrc
   

   此时在任意终端输入python，都会自动映射到python3。

方法二：配置VS Code关联指定Python解释器 #

1. 打开VS Code，按下Cmd+Shift+P（Mac）/Ctrl+Shift+P（Windows/Linux），输入Python: Select Interpreter；
2. 在弹出列表中选择目标解释器：
   • 若使用tensorflow虚拟环境，选路径包含/opt/homebrew/Caskroom/miniforge/base/envs/tensorflow/bin/python的选项；
   • 若使用全局Python，选/Library/Frameworks/Python.framework/Versions/3.10/bin/python3；
3. 可选：在项目根目录创建.vscode/settings.json文件，强制指定解释器并自动激活环境：

   {
       "python.pythonPath": "/opt/homebrew/Caskroom/miniforge/base/envs/tensorflow/bin/python",
       "python.terminal.activateEnvironment": true
   }
   

4. Homebrew版本Python的生效范围问题 #

你看到的Homebrew相关Python属于Conda虚拟环境，这类环境是完全隔离的：

• 只有在终端执行conda activate tensorflow激活虚拟环境后，才会优先使用该环境内的Python；
• 新终端默认处于全局环境，此时会使用系统默认的全局Python（即/Library/Frameworks下的版本）。
  如果需要让Homebrew直接安装的Python（非虚拟环境版）成为全局默认，可执行brew install python，Homebrew会自动将python和python3的路径配置到系统环境变量优先级更高的位置。

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