VS Code不会自动识别或切换到创建的.venv，必须显式选择解释器；否则默认使用系统Python或旧路径，导致状态栏不更新、ModuleNotFoundError等问题，根本原因是其Python扩展不监听shell激活状态，仅依赖手动配置或命令面板选择。
VS Code 不会自动识别或切换到你创建的 .venv，必须显式选择解释器，否则它默认用系统 Python 或上一个记住的路径。
为什么“创建了 .venv 却不生效”？
常见错误现象是：终端里能 source .venv/bin/activate（macOS/Linux）或 .venv\Scripts\activate（Windows），但 VS Code 的右下角状态栏仍显示系统 Python 路径，运行代码时 pip 安装的包报 ModuleNotFoundError。
根本原因是：VS Code 的 Python 扩展只依赖 python.defaultInterpreterPath 配置或命令面板选择结果，它不监听 shell 激活状态，也不解析 activate 脚本。
- 终端激活虚拟环境仅影响当前终端会话，对 VS Code 编辑器本身无作用
- 即使你在终端中执行了
code .启动 VS Code，它也不会继承终端的 Python 环境变量或解释器路径 - 如果项目根目录下有
.venv，但没手动选中，VS Code 通常只在首次打开时扫描一次，后续创建的.venv不会自动触发重发现
必须用 Python: Select Interpreter 重新选一次
这是最可靠、最直接的方式，适用于 venv、conda、poetry 等所有类型虚拟环境。
立即学习“Python免费学习笔记（深入）”；
- 确保项目文件夹已作为工作区打开（不是只打开单个
.py文件），否则 VS Code 可能找不到.venv - 按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux）调出命令面板 - 输入
Python: Select Interpreter，回车 - 在列表中找带
.venv、envs/或anaconda3/envs/字样的路径；若没出现，点Enter interpreter path...，然后手动定位到：.venv/bin/python（macOS/Linux）或.venv\Scripts\python.exe（Windows）
选完后，右下角状态栏会立刻变成该路径，且新打开的集成终端（Terminal → New Terminal）默认使用该解释器。
settings.json 中硬编码路径的风险与适用场景
当你需要为某个项目**强制锁定解释器**（比如 CI/CD 环境复现、团队协作避免误选），才推荐改 settings.json。
- 路径必须是绝对路径，相对路径（如
./.venv/bin/python）无效 - 不同成员机器路径不同，硬编码会导致配置不可移植；建议仅用于个人固定项目或 Docker 开发容器内
- 修改位置：打开命令面板 →
Preferences: Open Workspace Settings (JSON)→ 添加字段："python.defaultInterpreterPath": "/Users/you/project/.venv/bin/python"
- 改完后需重启 VS Code 终端或重载窗口（
Developer: Reload Window），否则旧终端仍沿用缓存
容易被忽略的三个细节
很多人卡在这几步，却反复检查“是不是没装扩展”：
-
Python扩展必须已启用，且不是Pylance单独启用——后者只提供语言支持，不管理解释器 - VS Code 集成终端默认使用的是你设置的「Default Profile」Shell（如 PowerShell），而 Windows 上 PowerShell 默认禁用脚本执行策略，导致
.venv\Scripts\activate.ps1报错；此时应切换 Default Profile 为Command Prompt，或临时运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 如果用 conda，不要选
anaconda3/bin/python，而要选具体 env 下的anaconda3/envs/myenv/bin/python；conda root 环境 ≠ 项目环境
