vs code 不自动创建或绑定 python 虚拟环境，需手动指定解释器路径；应在项目根目录用 python -m venv .venv 创建环境，再通过命令面板选择对应 python 可执行文件，并启用 python.terminal.activateenvironment 确保终端自动激活。
VS Code 本身不自动创建或绑定 Python 虚拟环境，必须手动指定解释器路径；否则所有项目共用系统 Python 或用户级 site-packages，依赖冲突几乎必然发生。
如何在 VS Code 中正确选择虚拟环境解释器
VS Code 的 Python 扩展通过 python.defaultInterpreterPath 或工作区设置中的 python.pythonPath（旧版）识别解释器。关键不是“配置虚拟环境”，而是让 VS Code 知道该用哪个 python 可执行文件。
- 先在项目根目录下创建虚拟环境：
python -m venv .venv（推荐放在项目内，如.venv或venv） - 打开项目文件夹后，按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入并选择Python: Select Interpreter - 在弹出列表中，优先选带
.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows）路径的项 —— 不要选系统/usr/bin/python3或C:\Python39\python.exe - 选中后，VS Code 会在当前工作区生成
.vscode/settings.json，写入类似："python.defaultInterpreterPath": "./.venv/bin/python"
（路径需与实际一致）
为什么 pip install 后模块仍报 ModuleNotFoundError
常见原因是：终端未激活虚拟环境，或 VS Code 集成终端未继承已选解释器。VS Code 的集成终端默认不自动激活虚拟环境，即使你已选了解释器。
- 检查当前终端是否使用了虚拟环境的 Python：
which python（macOS/Linux）或where python（Windows），输出应指向.venv/...下的路径 - 若不是，手动激活：
source .venv/bin/activate（macOS/Linux）或.venv\Scripts\activate（Windows） - 更稳妥的做法：在 VS Code 设置中启用
python.terminal.activateEnvironment（设为true），这样每次打开集成终端会自动激活当前工作区绑定的虚拟环境 - 确认
pip是否也来自该环境：pip --version输出的路径应与python -m pip --version一致
多项目共存时如何避免解释器路径混淆
VS Code 的解释器选择是**工作区级**的，不是全局的。但容易出错的点在于：打开文件夹方式不对，或误用了“Open File”而非“Open Folder”。
立即学习“Python免费学习笔记（深入）”；
- 务必通过
File > Open Folder...打开整个项目根目录（含.venv），而不是单个.py文件 —— 否则 VS Code 无法读取工作区设置，.vscode/settings.json会被忽略 - 不同项目各自维护独立的
.venv和.vscode/settings.json，互不影响；切勿把一个项目的.venv复制到另一个项目下使用 - 如果项目使用
poetry或conda，解释器路径分别为：poetry env info --path对应的bin/python，或conda env list中环境路径下的python.exe/bin/python
最容易被忽略的是：VS Code 的 Python 解释器选择只影响代码分析、调试和运行，但终端是否激活、pip 是否装对位置，完全取决于你当前 shell 的上下文 —— 这两者不自动同步，必须手动验证路径一致性。
