VSCode找不到python、npm、g++或java的根本原因是GUI启动未加载shell环境变量，需将路径配置到系统级PATH（Windows）或~/.zprofile/~/.profile（macOS/Linux），并确保python.defaultInterpreterPath为绝对路径、扩展启用且项目以文件夹方式打开。
VSCode 启动后找不到 python、npm、g++ 或 java，不是软件没装，而是它压根没读到你系统里配好的 PATH——GUI 程序（比如从开始菜单或 Dock 点开的 VSCode）默认不加载 shell 配置文件里的环境变量，必须把关键路径塞进系统级或桌面会话级的环境变量中。
Windows 上 PATH 必须加进「系统变量」，不是「用户变量」
很多用户把 Python 装在 C:\Python311，然后只在「用户变量」的 Path 里加了这一条。结果 VSCode 找不到解释器，但 CMD 里 python --version 却能跑。这是因为：VSCode GUI 进程优先读取「系统变量」PATH；而用户变量 PATH 只对当前登录用户的子进程生效，且可能被桌面环境忽略。
- 打开「系统属性 → 高级 → 环境变量」，在「系统变量」区域找到
Path，点击「编辑」 - 新增两行（路径按你实际安装位置调整）：
C:\Python311和C:\Python311\Scripts - 若装了 MinGW-w64，也加
C:\msys64\ucrt64\bin（对应 UCRT64 环境） - 改完必须完全退出 VSCode（右键任务栏图标 → 退出），再重新打开，仅「重载窗口」无效
- 注意检查 PATH 中是否混入了双引号，例如
"C:\WINDOWS\system32"—— VSCode 的 Python 扩展会直接跳过整条含双引号的路径
macOS/Linux 要写进 ~/.zprofile 或 ~/.profile，不是 ~/.zshrc
你在 iTerm 里执行 echo $PATH 能看到 /opt/homebrew/bin，但 VSCode 集成终端里却不见踪影？GUI 应用（包括 VSCode）启动时只读 ~/.zprofile（zsh 默认）或 ~/.profile（bash 或桌面环境通用），不读 ~/.zshrc。
- 把
export PATH="/opt/homebrew/bin:$PATH"这类语句移到~/.zprofile（macOS Sonoma 及以后）或~/.profile（Linux 或旧版 macOS） - 运行
source ~/.zprofile（或source ~/.profile）让当前终端立即生效 - 完全退出 VSCode（不是关窗口），再从 Dock 或 Launchpad 重启
- 验证方式：打开 VSCode 集成终端，输入
echo $PATH，确认输出包含你添加的路径
python.defaultInterpreterPath 必须是绝对路径，且精确到可执行文件
即使系统 PATH 正确，VSCode 仍可能提示「选择解释器失败」，常见于手动配置 python.defaultInterpreterPath 时路径写错。
- 该设置只在工作区生效（即写在
.vscode/settings.json里），全局设置无效 - 值必须是绝对路径：
/Users/you/.pyenv/versions/3.11.5/bin/python✅，~/.pyenv/versions/3.11.5/bin/python❌（波浪线不展开） - Windows 上反斜杠要转义或改斜杠：
C:/myenv/python.exe✅，C:\myenv\python.exe✅，C:\myenv\python.exe❌（JSON 解析失败） - 路径末尾不能是目录：
.venv/bin/python✅，.venv/bin/❌（VSCode 会跳过） - 路径含中文、空格或括号（如
project(2024)）会导致 VSCode 完全不扫描该目录，也不报错 —— 换个纯英文无空格路径重试最省事
conda / pyenv / venv 的解释器不能靠“猜”，得给硬路径
VSCode 不会执行 conda activate 或调用 pyenv shell，它只认死路径。你在终端里 which python 返回的是 shim 脚本，不是真实解释器。
-
conda：先在 VSCode 终端里运行conda info --json，失败说明 conda 命令不可见；需在settings.json中显式设"python.condaPath"，值为conda可执行文件绝对路径（如/opt/anaconda3/bin/conda） -
pyenv：别用which python，改用pyenv which python获取真实路径（如~/.pyenv/versions/3.11.5/bin/python） -
venv：新建.venv后，解释器列表常不刷新；按Ctrl+Shift+P→Developer: Reload Window，或直接关掉整个 VSCode 窗口重开
最容易被忽略的一点：VSCode 的 Python 支持完全依赖 ms-python.python 扩展，左下角那个「Python 3.x」提示就是它在干活。如果扩展未启用、卡在 Activating，或被禁用，所有路径配置都白搭 —— 先去扩展面板确认状态，再查路径。
