VSCode找不到Python虚拟环境，90%是因未被扫描到：仅检查项目根目录下.venv/venv/env等标准命名文件夹，不递归、不猜路径；须指定到具体可执行文件（如venv/bin/python或venv\Scripts\python.exe），路径含中文/空格/括号会被跳过；新环境需重载窗口或重启VSCode。
VSCode 找不到 Python 虚拟环境，90% 不是插件坏了，而是它压根没“看见”你的 python 可执行文件——路径不对、位置太深、名字不标准，或者根本没被扫描到。
为什么 Python: Select Interpreter 列表里没有你的 venv
VSCode 的 Python 扩展默认只在项目根目录下检查几个固定名字的文件夹：.venv、venv、env。它不会递归搜索子目录，也不会猜路径。
- 你把虚拟环境建在
~/pyenvs/myproject/？VSCode 默认不查这个位置 - 你用
python -m venv myenv创建，但选解释器时点了myenv文件夹而不是myenv/bin/python（macOS/Linux）或myenv\Scripts\python.exe（Windows）？VSCode 会静默失败 - 路径含中文、空格或括号（比如
项目(2024)）？VSCode 直接跳过整个路径，这是硬限制 - 刚创建完
.venv就打开 VSCode？需要手动重载窗口：Ctrl+Shift+P→Developer: Reload Window
pipenv 和 poetry 环境为什么总不出现
因为 pipenv 把环境藏在用户目录（如 ~/.local/share/virtualenvs/xxx-hash/bin/python），poetry 也类似（poetry env info --path 输出的路径）。这些路径不在 VSCode 默认扫描范围内。
- 别指望自动发现——必须手动指定：
Ctrl+Shift+P→Python: Select Interpreter→Enter interpreter path→ 粘贴pipenv --py或poetry env info --path输出的完整路径 - 写死进
.vscode/settings.json的python.defaultInterpreterPath值可以生效，但 hash 会变；想长期稳定，得每次用命令重新生成路径再粘贴 - 确认
Pipfile或pyproject.toml在项目根目录，否则pipenv --py可能报错或返回错环境
Conda 环境显示两次或根本找不到
conda 环境路径重复（比如嵌套在另一个环境里）、conda 命令不可达、或 VSCode 启动时用的 shell 没加载 conda 初始化，都会导致识别失败。
立即学习“Python免费学习笔记（深入）”；
- 运行
conda env list，检查有没有两行指向同一环境（尤其注意路径里含中文或.conda子目录的脏数据），用conda env remove -p /path/to/wrong/env清理 - 确保终端里能直接运行
conda activate myenv && python -c "print('ok')"；不能就先conda init zsh（或 bash/powershell），再source ~/.zshrc - 更稳的方式：在终端执行
conda init vscode，然后彻底关闭并重启 VSCode（不是重载窗口） - 别选
base环境——它容易因升级损坏，且不隔离依赖
选对了解释器，import 还是报错
解释器路径设对了，只是第一步。VSCode 的终端、调试器（launch.json）、Jupyter kernel 是各自独立加载环境的，互不继承。
- 右下角状态栏显示路径是对的，但终端左上角还是
bash？关掉所有 terminal tab，新开一个——它才可能继承当前解释器环境 - 调试时报
ModuleNotFoundError？检查launch.json里有没有"cwd": "${fileDirname}"，否则默认以工作区根目录为起点导入 - Jupyter notebook 单元格右上角 kernel 下拉菜单 ≠ 编辑器解释器，要单独点选匹配项
- 改完
settings.json后不重启 VSCode？Pylance 会缓存旧环境类型信息，很多问题 reload window 都解决不了，必须彻底重启
最常被忽略的一点：VSCode 的 Python 扩展和它的集成终端，根本不是一套逻辑。编辑器认的是你手动喂给它的 python 文件路径，终端认的是系统 PATH 和 shell 初始化脚本。两者对齐，靠的不是运气，是每一步都指到具体可执行文件、每个配置都落在正确层级、每次变更后都按需重启。
