Mac系统VSCode运行Python报错/bin/sh: python: command not found求助

核心问题说明 #

Mac系统默认没有python命令，只有python3——VSCode如果默认调用python，就会触发找不到命令的报错。以下是具体排查和解决步骤：

第一步：确认Python3的安装路径 #

打开终端，运行：

which python3

会得到类似/usr/local/bin/python3（Intel芯片）或/opt/homebrew/bin/python3（M系列芯片）的路径，先记录下来。

第二步：检查VSCode的Python解释器配置 #

1. 在VSCode中按下Cmd+Shift+P调出命令面板
2. 输入Python: Select Interpreter，选择你通过Homebrew安装的Python3版本（选项通常会带有brew标识）

第三步：针对性解决方法 #

方案1：给Python3创建python软链接

让系统识别python命令指向python3，终端运行：

ln -s $(which python3) /usr/local/bin/python

如果提示权限不足，添加sudo：

sudo ln -s $(which python3) /usr/local/bin/python

之后在终端输入python --version，能正常显示版本即说明生效。

方案2：修改VSCode的运行配置

如果不想修改系统命令，直接让VSCode用python3运行脚本：

1. 打开VSCode的.vscode/launch.json文件（无此文件时，按Cmd+Shift+P输入Debug: Open launch.json创建）
2. 修改配置确保调用python3，示例配置：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: 当前文件",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            "python": "python3"
        }
    ]
}

方案3：检查终端环境变量

确保Homebrew的Python路径在系统PATH中：

1. 终端运行echo $PATH，查看是否包含第一步得到的路径（如/usr/local/bin或/opt/homebrew/bin）
2. 如果没有，打开~/.zshrc（zsh终端）或~/.bash_profile（bash终端），添加：

# Intel芯片适用
export PATH="/usr/local/bin:$PATH"
# M系列芯片适用
export PATH="/opt/homebrew/bin:$PATH"

3. 运行source ~/.zshrc（或对应配置文件）让修改生效

最后：重启VSCode #

无论使用哪种方案，修改后完全关闭VSCode再重新打开，确保配置生效。

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