Mac Pro 2021上VSCode提示无法找到Python的问题求助

1. 手动指定Python解释器路径 #

• 打开VSCode，按下Cmd+Shift+P调出命令面板
• 输入Python: Select Interpreter，选择Enter interpreter path...
• 输入Python 3.11的实际路径：
  • 官网安装的默认路径：/Library/Frameworks/Python.framework/Versions/3.11/bin/python3
  • Homebrew安装路径（M系列芯片）：/opt/homebrew/bin/python3.11；Intel芯片：/usr/local/bin/python3.11
• 选择后VSCode会自动保存配置，下次打开即可识别

2. 同步VSCode与系统Shell的Python路径 #

• 打开终端，运行which python3和python3 --version，确认输出的是3.11.0的路径和版本
• 如果终端能识别但VSCode不行，配置VSCode的Shell和默认解释器：
  1. 按Cmd+,打开设置，搜索terminal.integrated.defaultProfile.osx，选择你常用的Shell（zsh/bash）
  2. 搜索python.defaultInterpreterPath，填入终端which python3得到的路径

3. 重置Python扩展缓存 #

• 完全关闭VSCode
• 打开Finder，前往~/Library/Application Support/Code/User/workspaceStorage
• 删除所有含ms-python.python的文件夹
• 重新打开VSCode，再选一次解释器

4. 检查环境变量配置 #

• 打开终端配置文件（比如~/.zshrc或~/.bash_profile），添加或确认以下配置：

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

• 保存后运行source ~/.zshrc（对应你的配置文件），重启VSCode

5. 排查工作区设置冲突 #

• 打开当前项目的.vscode/settings.json，检查是否存在错误的python.pythonPath配置
• 如果有错误路径，修改为正确值，或者直接删除该配置项让VSCode自动识别

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