VSCode终端所有命令报“command not found”是因为默认启动non-login shell，跳过~/.zshrc等配置文件导致PATH缺失；需将terminal.integrated.shellArgs设为["-l"]并彻底重启VSCode验证。
VSCode里所有命令都报“command not found”，不是你没装工具，是它根本没拿到你的PATH。
为什么系统终端能跑，VSCode终端却找不到命令
VSCode默认启动的是non-login shell，直接跳过~/.zshrc、~/.bash_profile甚至~/.profile——里面所有export PATH=...全被忽略。所以node、npm、python、claude、nvm这些命令，在iTerm或Terminal里好好的，进VSCode就消失。
验证很简单：echo $PATH（macOS/Linux）或echo %PATH%（Windows），把同一行命令分别粘贴到系统终端和VSCode集成终端里执行，逐行比对输出。缺了这些路径基本就能定位问题：
-
/opt/homebrew/bin（Apple Silicon Homebrew） -
$HOME/.nvm/versions/node/v18.18.2/bin（nvm管理的Node） -
%APPDATA% pm（Windows npm全局模块） -
~/.local/bin（pip install --user安装的命令）
macOS/Linux：必须启用login shell
这是最常见也最有效的修复方式。VSCode不读shell配置文件，就让它读——通过-l参数强制走login流程。
- 打开VSCode设置（
Cmd + ,），搜索terminal.integrated.shellArgs - 找到对应shell（如
zsh或bash）的profile配置，把args设为["-l"]（注意是小写L，不是数字1） - 关闭所有已打开的集成终端（不只是关标签页，要确保进程退出）
- 按
Ctrl + `新建终端，再运行echo $PATH确认是否生效
如果仍无效，检查~/.zshrc开头是否有类似[[ -n $ZSH_EVAL_CONTEXT ]] && return的提前退出逻辑——它会让后续所有export失效。临时加一行echo "zshrc loaded"就能验证是否真被加载。
Windows：别信图形入口，手动补PATH最稳
从开始菜单或桌面图标双击启动的VSCode，拿不到用户环境变量（尤其是%APPDATA%
pm、C:Program FilesGitin）。两个靠谱解法：
-
长期方案：进「系统属性 → 高级 → 环境变量」，把关键路径加进「用户变量」里的
Path，然后用任务管理器结束所有Code.exe进程，再重启 -
应急方案：VSCode设置中搜
terminal.integrated.env.windows，填入：{"PATH": "${env:PATH};C:\Users\XXX\AppData\Roaming\npm;C:\Program Files\Git\bin"}（注意反斜杠必须双写，路径间用分号拼接）
特别注意：PATH在Windows注册表中有2048字符硬限制，超长会被截断，别堆太多路径。
nvm、conda、pyenv等工具链单独处理
这类版本管理器往往依赖shell函数而非单纯二进制路径，仅靠PATH不够。
- nvm-windows：在
settings.json里加"terminal.integrated.env.windows": { "NVM_HOME": "${env:NVM_HOME}", "NVM_SYMLINK": "${env:NVM_SYMLINK}" } - conda：确保
conda init已运行，并在VSCode设置中启用"terminal.integrated.inheritEnv": true - pyenv：macOS/Linux下需确认
pyenv init输出的export语句已写入~/.zshrc，且未被提前return拦截
复杂点在于：有些工具（比如claude CLI）本身不依赖PATH，而是靠扩展主动探测；这时候即使PATH对了，扩展也可能因权限、安装方式或CLI未初始化而失败——得单独验证which claude和claude --version是否在VSCode终端里真正可用。
