如何确保VSCode中的Python项目使用虚拟环境而非全局环境

前置校验 #

先执行以下命令确认环境状态：

• 执行pip -V和python -V，确认两者输出的路径均指向你创建的my_venv目录，没有匹配全局Python路径
• Mac/Linux执行which python，Windows执行where python，确认输出的第一条路径是my_venv下的Python可执行文件
• 执行python -c "import sys; print(sys.path)"，确认my_venv对应的site-packages目录在路径列表中优先级高于全局Python的site-packages目录

核心解决步骤 #

1. 更新运行调试配置 #

多数情况下选了左下角解释器后，旧的运行配置没有同步更新，导致调用全局环境：

• 打开VSCode侧边栏「运行和调试」面板，点击「创建launch.json文件」，选择Python分类下的「Python文件」模板
• 生成的launch.json中，确认configurations数组下的python字段值为${command:python.interpreterPath}，该配置会自动读取你选中的虚拟环境解释器路径
• 保存配置后重启VSCode再运行代码测试

2. 修正终端环境配置 #

部分系统默认在终端启动时加载全局Python环境变量，覆盖虚拟环境激活状态：

• 打开VSCode设置，搜索python.terminal.activateEnvironment，确认该选项处于勾选状态，开启终端自动激活当前选中的虚拟环境
• 搜索terminal.integrated.inheritEnv，取消勾选该选项，避免终端继承系统全局的Python环境变量
• 关闭所有已打开的内置终端，重新打开终端后前缀会显示(my_venv)的激活标识，再运行代码即可

3. 手动指定解释器运行（临时绕过方案） #

如果配置修改后仍不生效，可以直接调用虚拟环境下的Python可执行文件运行代码，确保调用的是虚拟环境依赖：

• Windows系统执行：.\my_venv\Scripts\python.exe 你的启动文件名.py
• Mac/Linux系统执行：./my_venv/bin/python 你的启动文件名.py

4. 清理项目缓存 #

如果上述操作都无效，清理VSCode本地项目缓存重试：

• 关闭VSCode，删除项目根目录下的.vscode文件夹
• 重新打开项目，重新选择my_venv作为解释器，重新安装依赖后再运行代码

内容的提问来源于stack exchange，提问作者Preston_Jarvis