适用于 Windows / macOS / Linux,含虚拟环境与 Conda 环境
1. 准备工作
- 已安装 VS Code 与 Python 扩展(Microsoft 出品)。
- 已安装目标 Python 版本(系统版、官网版、Anaconda、Miniconda、pyenv 均可)。
2. 快速切换(单项目生效)
| 步骤 | 操作说明 | 图示/快捷键 |
|---|---|---|
| ① 打开项目 | 把文件夹拖进 VS Code 或 File > Open Folder | — |
| ② 调出命令面板 | Ctrl+Shift+P(Win/Linux)Cmd+Shift+P(Mac) | 直接使用快捷键 |
| ③ 选择解释器 | 输入 Python: Select Interpreter 并回车 | |
| ④ 点选目标环境 | 列表里会显示: • 系统 Python • .venv / venv 虚拟环境• Conda 环境 • pyenv 版本 | 带 ★ 的为当前选中项 |
| ⑤ 验证 | 新建终端(Ctrl+`)执行python -V 或 which python | 路径应与所选一致 |
切换后,VS Code 底部状态栏的 Python 版本字样会立即更新。
此设置仅对当前工作区生效,不会污染全局配置。
3. 手动指定(未自动识别时)
若列表里找不到所需解释器:
- 在第 ④ 步选择 Enter interpreter path… → Find…
确认后,VS Code 会把该路径写入当前工作区的 .vscode/settings.json:
{"python.defaultInterpreterPath":"/absolute/path/to/python"}
浏览到对应可执行文件:
| 平台 | 典型路径示例 |
|---|---|
| Windows | C:\Users\<User>\AppData\Local\Programs\Python\Python311\python.exe |
| macOS | /usr/local/bin/python3.11 或 ~/.pyenv/versions/3.11.6/bin/python |
| Linux | /usr/bin/python3.11 或 |

