VSCode集成终端报“command not found”是因GUI启动未加载shell配置导致PATH缺失；macOS/Linux需设terminal.integrated.shellArgs为["-l"]启用login shell，Windows需在系统环境变量中添加对应路径，并在launch.json或tasks.json中通过env字段补全PATH。
VSCode集成终端里敲 python、node、npm 报 “command not found”，不是软件没装，是 VSCode 启动时压根没加载你的 shell 配置文件（比如 ~/.zshrc），PATH 被砍掉一大截。GUI 启动的进程默认走 non-login shell，跳过所有 export PATH= 逻辑。
验证是不是 PATH 缺失
在 VSCode 内置终端（Ctrl + `）里执行：
echo $PATH
再打开系统原生终端（如 Terminal/iTerm 或 CMD/PowerShell）执行同一命令，对比输出。常见缺失路径包括：
-
/opt/homebrew/bin（Apple Silicon Homebrew） -
~/.pyenv/shims或~/.pyenv/versions/3.11.5/bin -
%APPDATA%\npm（Windows npm 全局模块路径） -
/usr/local/bin（Intel Mac Homebrew / 大多数源码安装路径）
macOS/Linux：强制启用 login shell
这是最稳、最通用的解法，不依赖配置文件位置，直接让 shell 自己去加载该加载的文件。
- 在 VSCode 设置中搜索
terminal.integrated.shellArgs，设为["-l"]（小写 L，不是数字 1） - 必须彻底退出 VSCode：macOS 右键 Dock 图标 →「退出」；Windows 在任务栏右键 →「退出」
- 重启后，关闭所有已打开的集成终端标签页，再按
Ctrl + `新建一个才生效 - 如果
~/.zshrc开头有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护，它会提前退出——加一行echo "zshrc loaded"就能验证是否真被读取
Windows：改系统变量 + 彻底重启
图形界面启动的 VSCode 不继承你在 CMD 里临时改的 PATH，只认「系统属性」里配的系统级 Path。
- 打开「系统属性 → 高级 → 环境变量」，在「系统变量」的
Path里新增两行：C:\Python312C:\Python312\Scripts
（Node.js 同理加C:\Program Files\nodejs\） - 别加双引号，也别写
C:\Python312\python.exe—— 只要目录，不要可执行文件 - 改完必须彻底退出 VSCode（不是「重载窗口」），再从开始菜单或桌面快捷方式重开
- npm 全局模块默认装在
%APPDATA%\npm，这个路径也要手动加进用户变量的Path中
调试器和任务仍报 command not found？补 env 字段
终端能跑 ≠ 调试器（F5）或构建任务（tasks.json）能跑。它们启动的是全新进程，完全不继承终端环境。
-
launch.json里每个configuration都要单独加env字段："env": { "PATH": "${env:PATH}:/usr/local/bin" } -
tasks.json要在options.env里补："options": { "env": { "PATH": "${env:PATH}:/opt/homebrew/bin" } } - 注意平台键写法：
terminal.integrated.env.osx（macOS）、.linux（Linux）、.windows（Windows），写错等于没配 -
PATH是覆盖式注入，必须用${env:PATH}引用原始值，否则连ls都会报错
最容易被忽略的是：改完 shellArgs 或 env 后，旧终端进程还在缓存旧环境，关掉所有标签页再新建才是关键动作。调试器和任务的 env 字段不能省，它们和终端是三套完全独立的环境初始化流程。
