适用于 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 或 ~/.local/share/virtualenvs/proj/bin/python |
4. 设置默认解释器（全局新窗口生效）
想让每次打开新文件夹都自动使用同一解释器：
- 命令面板 →
Preferences: Open User Settings (JSON)
加入：
"python.defaultInterpreterPath":"/absolute/path/to/python"
注意：如果该工作区已经手动选过解释器，则全局设置会被覆盖。
5. 常用场景速查
| 场景 | 操作建议 |
|---|---|
| 为每个项目隔离依赖 | 项目根目录 python -m venv .venv → 激活 → 按第 2 步选 .venv/bin/python |
| 使用 Conda 环境 | conda create -n tf213 python=3.9 → 激活 → VS Code 会自动列出，或手动选 Enter interpreter path… |
| 使用 pyenv 多版本 | pyenv local 3.10.12 → 重启 VS Code → 解释器列表即出现对应版本 |
| 远程/WSL 开发 | 先在本机 WSL 内安装 Python → VS Code 连接 WSL → 步骤同上 |
6. 一键验证代码
新建 hello.py：
import sys, platform
print("当前解释器:", sys.executable)
print("版本:", platform.python_version())
点击右上角 ▶️ Run Python File 或 Ctrl+Alt+N，终端输出路径与状态栏一致即成功。
7. 常见问题
| 问题 | 解决思路 |
|---|---|
选完解释器后仍报错 No module named xxx | 检查终端提示符前是否有虚拟环境括号，若无，重启 VS Code 或手动激活环境 |
| 每次打开都要重新选 | 把路径写进工作区 .vscode/settings.json 或全局 settings.json |
| 状态栏不显示版本 | 确认已安装 Python 扩展；若仍不显示，命令面板 → Developer: Reload Window |
