VSCode需手动指定Python虚拟环境解释器路径，优先选带(venv)标记的路径或通过Enter interpreter path...导航至venv/bin/python（macOS/Linux）或Scripts\python.exe（Windows），路径须为相对于工作区根目录的相对路径；推荐用python -m venv .venv创建环境以确保兼容性；调试时需确认python.defaultInterpreterPath正确、python.terminal.activateEnvironment为true，并在launch.json中按需配置PYTHONPATH和cwd。
如何让VSCode识别已存在的Python虚拟环境
VSCode不会自动扫描项目目录下的 venv、.venv 或 env 文件夹，必须手动指定解释器路径。常见现象是：终端能正常激活虚拟环境，但VSCode的Python扩展仍提示“未选择解释器”或代码补全/调试失效。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并选择Python: Select Interpreter - 在弹出的列表中，优先选带
(venv)标记的路径；若没出现，点击Enter interpreter path...，然后导航到你的虚拟环境目录下的bin/python（macOS/Linux）或Scripts\python.exe（Windows） - 确认后，VSCode会在当前工作区生成
.vscode/settings.json，写入类似"python.defaultInterpreterPath": "./.venv/bin/python"的配置 —— 这个路径必须是**相对于工作区根目录的相对路径**，否则跨机器打开会失效
为什么用 python -m venv 创建比 virtualenv 更稳妥
VSCode的Python扩展对 venv 模块创建的环境兼容性最好。用第三方工具如 virtualenv 或 pipenv 时，可能因激活脚本结构差异导致解释器路径识别失败，尤其在Windows上常报错 ModuleNotFoundError: No module named 'venv'。
- 推荐统一使用标准库命令：
python -m venv .venv（Python ≥ 3.3） - 避免用
virtualenv .venv，除非明确需要旧版Python支持 - 创建后立即在VSCode中执行
Python: Select Interpreter，不要等安装完包再选 —— 否则可能误选系统Python
调试时提示 ModuleNotFoundError 的真实原因
不是环境没选对，而是VSCode调试器默认不读取shell激活状态，也不会自动把虚拟环境的 site-packages 加进 PYTHONPATH。即使解释器路径正确，如果代码里用了相对导入或非标准包路径，依然会报错。
- 检查
launch.json中是否显式设置了"env": {"PYTHONPATH": "${workspaceFolder}"}（按需添加） - 确保
python.defaultInterpreterPath指向的是虚拟环境里的python，而不是系统Python —— 可在集成终端运行which python（macOS/Linux）或where python（Windows）验证 - 如果用了
src/目录结构，需在launch.json中加"cwd": "${workspaceFolder}/src"，否则模块查找起点错误
settings.json 里哪些配置真正影响虚拟环境行为
VSCode的Python行为由多个层级配置叠加决定，工作区级 .vscode/settings.json 优先级最高，但容易被用户忽略的是 python.terminal.activateEnvironment 这个开关。
立即学习“Python免费学习笔记（深入）”；
-
"python.defaultInterpreterPath"：必须存在且路径有效，否则所有功能退化为系统Python -
"python.terminal.activateEnvironment"：设为true才能让集成终端自动激活虚拟环境（默认是true，但某些旧版本或重装扩展后可能被重置） -
"python.testing.pytestArgs"等测试相关配置，如果路径含空格（如C:\My Project\.venv\Scripts\pytest.exe），必须用双引号包裹整个路径，否则启动失败
虚拟环境本身是轻量的，但VSCode对它的感知非常依赖路径精度和配置开关的显式声明 —— 少一个斜杠、多一个空格、漏关一个布尔值，都可能导致看似“已配置成功”实则静默失效。
