VSCode终端报“command not found”主因是未加载shell配置导致PATH缺失，需设terminal.integrated.shellArgs为["-l"]、验证$PATH、修复shell初始化或手动补PATH。
VSCode终端里command not found，不是命令没装，是它压根没拿到你系统里配好的PATH——图形界面启动时绕过了shell初始化流程，$PATH被截断或完全缺失。
为什么echo $PATH在VSCode终端里缺关键路径
macOS/Linux下VSCode默认启动non-login shell，跳过~/.zshrc或~/.bash_profile；Windows下则常因以管理员身份运行、或未将Node.js/MinGW路径写入“系统变量”导致继承失败。最典型现象：系统终端能跑node、g++、brew，VSCode里全报错。
- 先验证：在VSCode集成终端执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），复制输出，粘贴到系统终端对比缺失项 - 常见缺失路径：
%APPDATA%\npm（Windows npm全局）、/opt/homebrew/bin（Apple Silicon Homebrew）、C:\mingw64\bin（MinGW） - 别信“已重启VSCode”——必须杀掉所有后台进程（macOS Activity Monitor查
Code Helper，Windows任务管理器结束Code.exe所有实例）
terminal.integrated.shellArgs: ["-l"]必须设对
这是macOS/Linux用户最有效的解法，强制终端走login流程加载shell配置。但容易踩坑：
-
["-l"]里的l是小写L，不是数字1；设成["-i"]或["--login"]无效 - 改完设置后，必须关闭所有已打开的集成终端（不只是关标签页，要关整个终端面板），再用
Ctrl+`新建一个 - 如果
~/.zshrc开头有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护逻辑，会提前退出，导致后续export PATH=...不执行；临时加echo "loaded"可验证是否真被读取
tasks.json和launch.json里的env字段不能复用终端配置
终端能跑gcc，不代表tasks.json里的构建任务或launch.json里的调试器也能——它们启动的是全新进程，环境完全隔离。
-
tasks.json中需在options.env里手动补PATH："PATH": "${env:PATH}:/mingw64/bin"（Windows用;拼接，Linux/macOS用:） -
launch.json中调试Node.js/Python时，envFile字段只读.env文件，但env字段必须显式声明："env": {"NODE_ENV": "development", "PATH": "${env:PATH}:/usr/local/bin"} - 别把
env写在configurations外层——那是无效位置；也别用已弃用的environment字段
Windows用户特别注意PATH长度和权限陷阱
Windows注册表对PATH有2048字符硬限制，且VSCode若以管理员身份运行，会继承系统级环境而非当前用户PATH，导致%APPDATA%\npm等用户路径彻底丢失。
- 检查PATH长度：
echo %PATH% | wc -c（PowerShell）或直接数字符；超长就删掉重复/失效条目，比如多个node_modules/.bin路径 - 避免管理员模式运行VSCode——右键图标属性里取消“以管理员身份运行”勾选
- Node.js通过
nvm-windows安装时，必须把nvm目录（如C:\Users\XXX\AppData\Roaming\nvm）和当前激活的nodejs路径（如C:\Program Files\nodejs）都加进“系统变量”的Path，仅靠nvm use临时切换无效
真正麻烦的不是配一次PATH，而是不同场景（终端 / 任务 / 调试 / 扩展）各自维护一套环境变量逻辑；稍不注意，改了这里漏了那里。最稳的做法：关键工具路径优先写死，环境变量只作兜底。
