在VS Code中切换和设置Python解释器的完整指南
作者：算法小狂人
这篇文章主要为大家详细介绍了在VS Code中切换Python环境的详细方法,支持Windows/macOS/Linux系统及虚拟环境/Conda环境,有需要的小伙伴可以了解下
适用于 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…
浏览到对应可执行文件：
| 平台 | 典型路径示例 |
|---|---|
| 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. 设置默认解释器（全局新窗口生效）
想让每次打开新文件夹都自动使用同一解释器：
命令面板 → 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 |
到此这篇关于在VS Code中切换和设置Python解释器的完整指南的文章就介绍到这了,更多相关VS Code切换和设置Python解释器内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！