在 vscode 中切换 python 虚拟环境 需先确保环境已创建并位于项目目录内,再通过命令面板选择解释器,路径将自动写入 .vscode/settings.json,最后通过 sys.executable 和终端提示符验证生效。

在 VSCode 中切换 Python 虚拟环境 其实很直接,关键是让编辑器识别并正确加载目标环境的解释器和依赖路径。
确认虚拟环境已创建并可访问
VSCode 本身不负责创建虚拟环境,它只负责调用已存在的环境。确保你已在项目目录下通过 venv、poetry 或 conda 创建了虚拟环境,例如:
-
python -m venv .venv(生成.venv文件夹) -
poetry env info --path(获取 Poetry 环境路径) -
conda env list(查看 Conda 环境位置)
路径必须对 VSCode 可见——建议把虚拟环境放在工作区根目录或子目录中,避免使用绝对路径或系统级环境。
通过命令面板快速选择解释器
按下 Ctrl+Shift+P(windows/linux)或 Cmd+Shift+P(macOS),输入 Python: select Interpreter,回车。
立即学习“Python 免费学习笔记(深入)”;
- VSCode 会自动扫描项目内常见位置(如
.venv、venv、env)及系统 Python 安装 - 若未显示目标环境,点击 Enter interpreter path…,手动浏览到
bin/python(macOS/Linux)或Scriptspython.exe(windows) - 选中后,VSCode 会在右下角状态栏显示当前解释器路径,同时激活对应环境的包补全与 linting
为多环境项目设置工作区级解释器
如果一个工作区含多个子项目(如前 后端 混合),每个子目录用不同虚拟环境,可为文件夹单独配置解释器:
- 打开对应子文件夹,在命令面板中执行 Python: Select Interpreter
- 选择后,VSCode 会将路径写入该文件夹下的
.vscode/settings.json,内容类似:"python.defaultInterpreterPath": "./.venv/bin/python" - 这样切换文件夹时,解释器会自动适配,无需重复选择
验证环境是否真正生效
光看状态栏还不够,建议做两件事确认:
- 在 Python 文件中输入
import sys; print(sys.executable),运行后输出路径应与所选解释器一致 - 打开集成终端(Ctrl+`),检查是否自动激活了对应环境(如提示符含
(.venv)或路径信息);若未激活,可在终端中手动运行source .venv/bin/activate(Linux/macos)或.venvScriptsactivate(Windows)
终端激活与否不影响代码运行,但影响 pip 安装位置和命令行 工具 可用性。
以上就是在 VSCode 中无缝切换 Python