VSCode终端报“command not found”主因是未加载shell配置导致PATH缺失，需检查terminal.integrated.shellArgs是否设为["-l"]、验证$PATH、修复shell初始化或手动补PATH。
VSCode终端报“command not found”，90%不是插件或安装问题，而是它根本没拿到你系统里配好的PATH。 你能在系统终端里跑通node、git、g++，但在VSCode集成终端里就失败——这不是命令丢了，是VSCode启动时“没带通讯录”。
为什么VSCode终端不继承系统PATH
VSCode图形界面启动（比如双击图标、从开始菜单打开）时，Windows走的是登录会话环境，macOS走的是GUI launchd环境，它们默认不加载你的~/.zshrc、~/.bash_profile或Windows用户变量里的Path。结果就是：你亲手加进Path的C:\Users\XXX\AppData\Roaming\npm或/opt/homebrew/bin，VSCode压根看不见。
- macOS/Linux用户常见于用
brew install node或nvm install后，npm在iTerm里可用，VSCode里报错 - Windows用户常见于MinGW、Git、Python安装时漏勾“Add to PATH”，或手动加了路径但没重启VSCode
- 所有平台都可能因PATH超长（尤其Windows注册表有2048字符限制）、多版本冲突（如WSL Git vs Windows Git）导致部分路径被截断或忽略
验证PATH是否生效的最快方式
别猜，直接看。在VSCode集成终端里执行：echo $PATH（macOS/Linux）或echo %PATH%（Windows），然后复制输出，粘贴到系统终端里对比。缺失的关键路径通常包括：
- Node.js全局模块路径：
%APPDATA%\npm（Windows）或$(npm config get prefix)/bin（macOS/Linux） - Homebrew路径：
/opt/homebrew/bin（Apple Silicon）或/usr/local/bin（Intel） - MinGW路径：
C:\mingw64\bin - Python pip user install路径：
%APPDATA%\Python\Python311\Scripts（Windows）或~/.local/bin（macOS/Linux）
如果这些路径在VSCode终端的$PATH里完全没出现，说明环境变量根本没加载进来。
macOS/Linux：必须启用login shell
VSCode终端默认启动的是non-login shell，跳过~/.zshrc等初始化文件。解决方法是在设置中强制它走login流程：
- 打开VSCode设置（
Cmd+,），搜索terminal.integrated.shellArgs - 把值设为
["-l"]（小写L，不是数字1） - 关闭所有已打开的集成终端，再新建一个
如果仍不生效，检查你的shell配置文件是否被[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护逻辑提前退出；也可以临时在~/.zshrc末尾加一行echo "zshrc loaded"验证是否真被读取。
Windows：别信“系统变量”和快捷方式
很多人把Path加到“系统变量”里，然后用桌面快捷方式启动VSCode，结果还是找不到g++。这是因为：
- 系统变量修改后，需要**完全退出所有VSCode进程**（任务管理器里确认
Code.exe无残留），不能只是关窗口 - 管理员模式运行VSCode会继承另一套环境，与普通用户PATH隔离，务必以普通权限启动
- Git/Node.js安装时若没勾选“Add to PATH”，手动添加路径时容易写错：比如填了
C:\Program Files\Git却漏掉\bin子目录
更稳的做法是：在PowerShell里执行where git或where node，拿到真实路径后，只往“用户变量”→Path里添加对应\bin目录，避免污染系统级环境。
最易被忽略的一点：VSCode的git.path、python.defaultInterpreter等配置，只影响编辑器内部功能（如源码管理面板、调试器），对集成终端里的git、python命令完全无效。终端命令能不能跑，只取决于它启动时拿到的PATH——别的都是障眼法。
