如何为Visual Studio Code配置Python解释器

一、快速选择已安装的解释器 #

• 打开任意.py文件后，VS Code右下角会显示当前关联的解释器（未配置时显示“Select Python Interpreter”），直接点击即可进入选择列表。
• 也可通过快捷键唤起命令面板：Windows/Linux按Ctrl+Shift+P，Mac按Cmd+Shift+P，输入Python: Select Interpreter回车，在弹出列表中选目标解释器。

二、手动指定解释器路径 #

如果列表里没有需要的解释器，手动添加路径：

1. 打开命令面板，执行Python: Select Interpreter，选择Enter interpreter path...。
2. 导航到解释器可执行文件位置：
   • Windows：一般在C:\PythonXX\python.exe（XX为版本号），或虚拟环境的Scripts\python.exe。
   • Mac/Linux：通常是/usr/bin/python3，或虚拟环境的bin/python3。
3. 选中路径后，VS Code会自动关联该解释器。

三、固定项目专属解释器 #

通过项目的settings.json配置，确保每次打开项目都用指定解释器：

1. 在项目根目录新建.vscode文件夹，里面创建settings.json文件。
2. 添加以下配置（替换为你的解释器实际路径）：

{
    "python.defaultInterpreterPath": "/path/to/your/python/interpreter"
}

注：旧版本VS Code可能用python.pythonPath，以编辑器提示为准。

四、虚拟环境配置建议 #

推荐为每个项目单独创建虚拟环境，避免依赖冲突：

1. 打开项目终端，执行创建命令：
   • Windows：python -m venv .venv
   • Mac/Linux：python3 -m venv .venv
2. 激活虚拟环境：
   • Windows：.venv\Scripts\activate
   • Mac/Linux：source .venv/bin/activate
3. 回到VS Code，按之前的方法选择虚拟环境内的解释器即可。

五、常见问题处理 #

• 选好解释器后仍提示找不到模块，检查终端是否激活了对应虚拟环境，或重启VS Code生效。
• 若VS Code无法自动检测到解释器，确认该解释器已添加到系统环境变量中。

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