适用于 Windows / macOS / Linux，含虚拟环境与 Conda 环境
1. 准备工作
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…
浏览到对应可执行文件：
| 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 |
确认后，VS Code 会把该路径写入当前工作区的 .vscode/settings.json：
{
"python.defaultInterpreterPath": "/absolute/path/to/python"
}
4. 设置默认解释器（全局新窗口生效）
想让每次打开新文件夹都自动使用同一解释器：
注意：如果该工作区已经手动选过解释器，则全局设置会被覆盖。
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 |
