Mac端VS Code配置Python后运行报错‘python: command not found’求助

核心原因 #

MacOS从Big Sur版本开始，系统不再预装Python 2，也默认未创建python软链接指向Python 3。VS Code如果未指定正确的Python 3解释器，会默认调用python命令，导致找不到可执行文件。

解决步骤 #

• 确认Python 3安装状态
  打开终端执行python3 --version，若能显示版本号，说明已安装Python 3；若未安装，可通过Python官网下载安装包，或用Homebrew执行brew install python完成安装。

• 配置VS Code的Python解释器

  1. 按Cmd+Shift+P打开命令面板，输入Python: Select Interpreter，选择已安装的Python 3版本（例如Python 3.11.x）。
  2. 也可手动修改工作区配置文件.vscode/settings.json，添加以下内容（路径需替换为which python3查询到的实际路径）：

     {
         "python.pythonPath": "/usr/local/bin/python3"
     }
     

• 可选：创建python软链接（统一命令调用）
  在终端执行ln -s /usr/local/bin/python3 /usr/local/bin/python，之后验证python --version，若显示Python 3版本，说明软链接创建成功，后续可直接用python命令调用Python 3。

• 检查VS Code终端配置
  确保VS Code集成终端使用的shell（bash/zsh）能识别python3或python命令。可在VS Code设置中搜索terminal.integrated.defaultProfile.osx，确认默认shell配置后，重启终端重试。

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