VSCode找不到Python解释器是因为它不扫描全盘、不继承终端PATH、只认明确指定的绝对路径或默认固定位置；列表为空需先检查终端能否查到python、Python扩展是否启用并正常激活、执行Developer: Reload Window刷新，再排查conda/pyenv/venv路径、settings.json中错误的python.defaultInterpreterPath及GUI环境变量隔离问题。
VSCode找不到Python解释器，不是Python没装，而是它压根没“看见”那个python可执行文件——它不扫描全盘、不继承终端PATH、也不猜路径，只认你明确告诉它的绝对路径，或默认搜索列表里恰好存在的几个固定位置。
Python: Select Interpreter 列表为空怎么办
这说明VSCode连候选解释器都列不出来，常见于环境变量未加载或扩展未就绪。
- 先在系统终端运行
which python3（macOS/Linux）或where python（Windows），如果命令返回空，问题不在VSCode，而在PATH本身 - 检查左下角有没有蛇形图标：没有就说明
ms-python.python扩展没启用，去扩展面板确认状态是Enabled，不是Activating…——遇到后者直接关掉VSCode再重开 - 列表为空时别急着手动输路径，先执行
Developer: Reload Window刷新插件上下文，有时只是缓存卡住 - macOS用户注意：
echo $PATH在VSCode内置终端里输出的路径，很可能比你在iTerm里少一截（比如缺~/.pyenv/shims），这就坐实了GUI启动没读~/.zshrc
conda / pyenv / venv 环境为什么选不到
这些工具靠shell函数、软链接或动态PATH切换，VSCode要的是硬编码的绝对路径，不能靠“激活”来生效。
-
conda环境没出现？打开输出面板→选择Python频道，看有没有conda info --json失败日志；有就说明VSCode根本调不动conda，得在settings.json里加"python.condaPath"指向真实可执行文件（如/opt/anaconda3/bin/conda） -
pyenv用户注意：which python返回的~/.pyenv/shims/python只是代理，要用pyenv which python拿到真实路径，比如~/.pyenv/versions/3.11.5/bin/python - 虚拟环境路径写错一个字符就失效：Windows下
C:myenvpython.exe这种单反斜杠会被JSON解析为转义错误，必须写成C:/myenv/python.exe或C:\myenv\python.exe
.vscode/settings.json 里 python.defaultInterpreterPath 写死了错误路径
这个配置项优先级最高，一旦写错，VSCode会无视你手动选的解释器，甚至忽略全局设置。
立即学习“Python免费学习笔记（深入）”；
- 典型症状：你明明在命令面板里选了
~/myproject/venv/bin/python，右下角却还显示旧路径 - 打开项目根目录下的
.vscode/settings.json，查找python.defaultInterpreterPath，如果值是空字符串、null、或一个已删除/移动过的路径（比如"C:/old/python.exe"），就立即删掉这行 - 改完保存，不用重启VSCode，它通常几秒内自动重载配置
- Git同步项目时容易带入他人工作区的错误路径，建议把
.vscode加入.gitignore，或至少审阅settings.json
终端能跑 python，VSCode右下角却空白
这几乎100%是GUI启动方式导致的环境变量隔离问题，尤其macOS和Linux。
- 在VSCode内置终端执行
echo $PATH，对比你在iTerm/terminal里执行的结果——如果不一致，说明VSCode没读到你的~/.zshrc或~/.bash_profile - macOS最稳解法：把
export PATH=...挪到~/.zprofile（GUI应用会读它），然后完全退出VSCode再重开 - Windows用户检查：系统级PATH是否包含Python目录（如
C:Python311），仅用户级PATH在某些场景下不可见；改完记得重启VSCode，不是重载窗口 - 临时绕过：从终端运行
code .启动VSCode，确保它继承当前shell环境
最容易被忽略的点是：VSCode的Python插件和它的内置终端，走的是两套完全独立的路径发现逻辑。你在一个地方能跑通python --version，不代表另一个地方也能——它们甚至可能用着不同版本的python。验证唯一可靠的方式，是在VSCode内置终端里执行python -c "import sys; print(sys.executable)"，然后拿这个路径去核对所有配置。
