VSCode不会自动识别虚拟环境，必须手动指定解释器完整路径（如./.venv/bin/python或..venvScriptspython.exe），且需写入工作区.vscode/settings.json；列表为空时须点击“Enter interpreter path”手动输入，路径错误、含中文空格、未重载窗口或未启用python.terminal.activateEnvironment均会导致失败。
VSCode 不会自动识别或创建虚拟环境，必须显式指定解释器路径，且该路径必须指向虚拟环境内的 python 可执行文件本身，而不是环境目录或 shell wrapper。
为什么 Python: Select Interpreter 找不到你的 .venv
VSCode 默认不扫描项目目录下的 .venv、venv 或 env 文件夹。即使你已用 python -m venv .venv 成功创建，它也不会自动出现在解释器列表里。
- 列表为空时，必须点击
Enter interpreter path…，然后手动导航到.venv/bin/python（macOS/Linux）或.venvScriptspython.exe（Windows） - 路径必须是相对于工作区根目录的相对路径（如
"./.venv/bin/python"），否则跨机器打开会失效 - 若使用
virtualenv或pipenv创建的环境，可能因激活脚本结构差异导致 VSCode 无法正确加载 site-packages，优先用标准库python -m venv
Python: Create Environment 命令到底做了什么
这个命令是 Python 扩展封装的快捷入口，本质就是执行 python -m venv .venv，但它有明确行为边界：
- 只在当前工作区根目录下创建，名称固定为
.venv（不是venv），不可指定上级路径 - 不校验所选 Python 解释器是否真实可用——比如选了 Python 3.9，但系统只有 3.11，命令会静默失败，无错误提示
- 不会自动激活终端；即使状态栏显示
(.venv)，新开集成终端默认仍用系统python - 创建后需立刻执行
Python: Select Interpreter绑定，不要等装完包再选，否则容易误选系统解释器
终端不自动激活 .venv 的真实原因
VSCode 集成终端默认不继承解释器选择结果，必须开启激活开关，否则 which python 永远指向系统路径。
立即学习“Python免费学习笔记（深入）”；
- 在
settings.json中设"python.terminal.activateEnvironment": true（注意不是python.terminal.autoActivateEnvironment，后者已废弃） - Windows PowerShell 用户要检查
python.terminal.launchArgs是否被意外设为["-NoExit", "-Command", ""]，这会覆盖激活逻辑，建议清空该项 - 验证方式：新开终端后，提示符前缀应出现
(.venv)；没有就说明没激活成功，pip install实际装到了系统环境
conda 环境路径填错的典型表现
VSCode 不支持自动发现 conda 环境，手动填路径时稍有偏差就会报 ModuleNotFoundError 或调试器启动失败。
- 路径必须精确到
python文件本身，例如：C:UsersAliceminiconda3envsmyprojpython.exe（Windows）或/Users/alice/miniconda3/envs/myproj/bin/python（macOS/Linux） - 不能填 conda 环境目录（如
.../envs/myproj），也不能用conda activate myproj && which python得到的路径——那个可能是 shell wrapper，VSCode 无法调用 - 如果 conda 装在 WSL 里，而 VSCode 运行在 Windows，路径必须用
wsl$Ubuntuhomeliceminiconda3envsmyprojinpython格式，不能用\wsl$或直接挂载路径
最易被忽略的一点：所有配置（python.defaultInterpreterPath、python.terminal.activateEnvironment）都必须写入工作区级 .vscode/settings.json，而非用户级设置——后者会让所有项目强制共享同一环境，引发静默冲突。
