VS Code 不自带虚拟环境管理,需手动创建 venv 或 conda 环境并正确选择解释器;常见失败原因包括环境未创建、路径错误或解释器选错;务必通过命令面板选择解释器、在对应环境中安装包,并检查 settings.json 是否覆盖配置。

VS Code 本身不自带 Python 虚拟环境管理能力,它依赖你本地已创建好的 venv 或 conda 环境,并通过正确选择解释器来激活它们。配置失败的常见原因不是 VS Code 设置错了,而是环境没建好、路径没识别到、或解释器选错了。
如何创建并确认虚拟环境存在
VS Code 不会帮你创建虚拟环境,这步必须手动完成。推荐用 Python 内置的 venv 模块(无需额外安装):
python -m venv .venv
执行后会在当前目录生成 .venv 文件夹。注意:.venv 是默认命名,但 VS Code 并不强制要求这个名字;只要它是标准 venv 结构(含 bin/(macOS/Linux)或 Scripts/(Windows)子目录),就能被识别。
- Windows 用户:检查
.venv\Scripts\python.exe是否存在 - macOS/Linux 用户:检查
.venv/bin/python是否存在 - 如果用
conda create -n myenv python=3.11,环境路径在anaconda3/envs/myenv下,同样需确认python可执行文件存在
在 VS Code 中正确选择 Python 解释器
这是最关键的一步。VS Code 需要明确知道“用哪个 python 来运行代码和加载包”,这个动作叫“选择解释器”,不是“配置环境”。快捷键 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入并选择:Python: Select Interpreter。
立即学习“Python免费学习笔记(深入)”;
- 如果列表里自动出现了
.venv或myenv,直接选它 - 如果没出现,点
Enter interpreter path...,然后手动定位到上面提到的python可执行文件(如.venv/bin/python) - 选中后,VS Code 底部状态栏会显示该解释器路径,且
python相关功能(如 IntelliSense、调试、格式化)会基于该环境生效
包安装必须在选中的解释器下进行
即使解释器选对了,如果你在终端里直接敲 pip install requests,结果取决于当前终端是否已激活该虚拟环境。VS Code 的集成终端默认**不会自动激活**虚拟环境——除非你做了额外设置。
- 最稳妥的方式:在 VS Code 终端中先激活环境(Windows):
.venv\Scripts\activate,或(macOS/Linux):source .venv/bin/activate,再运行pip install - 更省事的方式:用 VS Code 命令面板运行
Python: Create Terminal,它会自动激活当前选中的解释器对应环境 - 验证是否装对:在 Python 文件里写
import requests,看有没有红线;或者在命令面板运行Python: Run Python File in Terminal,它也会使用当前解释器的包
为什么 pip list 看不到刚装的包?
大概率是终端用的不是你选中的那个解释器的 pip。运行以下命令确认:
which pip
或 Windows:
where pip
输出路径应与你选中的解释器路径一致(比如都在 .venv/bin/ 下)。如果不一致,说明你在系统全局 pip 或另一个环境中装了包。这时候要么切换终端环境,要么显式调用:
.venv/bin/python -m pip install requests
这才是真正“属于这个环境”的安装方式。VS Code 的扩展(如 Pylance)只读取当前解释器的 site-packages,不会跨环境扫描。
容易被忽略的一点:VS Code 工作区级别的 settings.json 中如果写了 "python.defaultInterpreterPath",它会覆盖你手动选择的结果;而用户级设置又可能覆盖工作区设置。遇到解释器反复“变回去”,优先检查这些配置项是否硬编码了错误路径。










