VSCode找不到虚拟环境的三大原因：一是pyvenv.cfg文件缺失或路径错误，需确认其存在于虚拟环境根目录；二是python.terminal.activateEnvironment未启用，导致终端不激活环境；三是用户级settings中python.defaultInterpreterPath未正确配置或被Settings Sync覆盖。
VSCode 里找不到虚拟环境，先看 pyvenv.cfg 是否还在
虚拟环境“丢失”往往不是真删了，而是 VSCode 找不到它——最常见原因是 pyvenv.cfg 文件缺失或路径错位。这个文件必须在虚拟环境根目录下（比如 .venv/pyvenv.cfg 或 venv/pyvenv.cfg），否则 VSCode 的 Python 插件压根不会把它当做一个有效环境扫描。
- 用终端进到你的项目目录，执行
ls -la .venv/（macOS/Linux）或dir .venv（Windows），确认pyvenv.cfg存在且非空 - 如果文件没了，别急着重建环境：先检查回收站、Git 历史（
git log --oneline --grep="pyvenv" -- .venv/pyvenv.cfg）、或备份工具里是否存有旧版本 - 手动补一个也行，但必须严格匹配你原来的 Python 版本和路径。内容至少含三行：
home = /path/to/system/python、include-system-site-packages = false、version = 3.x
python.terminal.activateEnvironment 没开，终端永远不认虚拟环境
你选对了解释器，sys.executable 也指向 .venv/bin/python，但终端里 pip list 还是显示系统包——大概率是这个开关关着。VSCode 不会自动 source 或 activate，它只靠这个配置项告诉终端：“新起的 shell 请自动加载环境”。
- 打开项目级
.vscode/settings.json，加一行："python.terminal.activateEnvironment": true - 改完必须关闭所有已打开的集成终端（不是关窗口，是关每个终端标签页），再新开一个才生效
- 注意：这不影响调试器，调试器走的是解释器路径，不走 shell 激活逻辑；也不影响外部终端（比如 iTerm 或 CMD）
VSCode 解释器列表为空？检查 python.defaultInterpreterPath 和用户级 settings
新建文件夹后点 Python: Select Interpreter，列表空空如也，甚至你刚创建的 .venv 都不出现——这不是插件坏了，是 VSCode 没扫描到你本地装的 Python 解释器。PATH 里有不等于 VSCode 认得，它只认“登记过”的路径。
- 按
Ctrl+Shift+P→Preferences: Open User Settings (JSON)，确保有这两行（路径替换成你的真实路径）："python.defaultInterpreterPath": "D:/exe/python31009/python.exe"、"python.interpreterPath": "D:/exe/python31009/python.exe" - 如果写的是相对路径或带空格/中文的路径，VSCode 可能静默跳过；建议用正斜杠
/或双反斜杠\ - 改完必须
Developer: Reload Window，否则设置不加载
重装 Python 插件或清缓存前，先关掉 Settings Sync
很多人试了一堆方法没用，最后发现是 Settings Sync 在捣鬼：你本地清掉了 settings.json，一重启，Sync 自动把上次存的错误配置又拉回来了——包括失效的 python.defaultInterpreterPath、坏掉的 python.venvPath，甚至残留的 pet.exe 扫描状态。
立即学习“Python免费学习笔记（深入）”；
- 关 Sync：命令面板搜
Sync: Turn off Settings Sync，选“全部关闭” - 再清缓存：彻底退出 VSCode（任务管理器里确认没
Code Helper进程），重命名%APPDATA%CodeUser（Win）或$HOME/Library/Application Support/Code/User（macOS）为User_backup - 重启 VSCode，它会生成全新 User 目录；此时再开 Sync，它会上传干净配置，而不是覆盖回来
真实恢复过程里，pyvenv.cfg 是起点，python.terminal.activateEnvironment 是终端能否用的关键，而用户级 python.defaultInterpreterPath 决定 VSCode 能不能“看见”你的 Python。三者漏一，环境就断一环。
