VSCode报“command not found”主因是集成终端未继承系统PATH：macOS/Linux需设terminal.integrated.shellArgs为["-l"]启用登录shell，Windows应将路径加入用户环境变量或手动配置terminal.integrated.env.windows，tasks/launch需在各自配置中显式声明PATH。
VSCode报“command not found”，90%不是命令没装，而是它根本没拿到你系统里配好的PATH。 你能在终端里跑通 node、git、conda 或 claude，但在 VSCode 集成终端里全挂——这不是工具问题，是环境链路断了。
为什么 VSCode 终端看不见你的 PATH
图形界面启动（双击图标、开始菜单）时，VSCode 绕过了 shell 初始化流程：
- macOS/Linux 默认起 non-login shell，跳过
~/.zshrc、~/.bash_profile，导致export PATH=...一行压根没执行 - Windows 不读用户级环境变量（比如
%APPDATA% pm），尤其当你以管理员身份运行 VSCode 时，只会继承系统 PATH，完全丢掉用户路径 - WSL2 下更复杂：Windows PATH 不会自动透传，得手动桥接
验证方式最直接：在 VSCode 终端里跑 echo $PATH（macOS/Linux）或 echo %PATH%（Windows），复制输出，粘贴到系统终端里逐行比对。缺了 /opt/homebrew/bin、C:mingw64in、%APPDATA%
pm 这类路径，就是确诊了。
macOS/Linux：必须设 terminal.integrated.shellArgs 为 ["-l"]
这是最通用有效的解法，但参数和操作细节容易出错：
- 打开 VSCode 设置（Cmd+,），搜
terminal.integrated.shellArgs - 设为
["-l"]——注意是小写 L，不是数字 1；["--login"]或["-i"]都无效 - 改完后必须彻底关闭所有已打开的集成终端（不只是关标签页，要关整个终端面板），再用
Ctrl+`新建一个 - 检查
~/.zshrc开头有没有[[ -n $ZSH_EVAL_CONTEXT ]] && return这类防护逻辑，它会让文件提前退出，后面所有export PATH被跳过；临时加一行echo "zshrc loaded"可验证是否真执行了
Windows：别信图形入口，要么重装 PATH，要么手动补
图形界面启动的 VSCode 拿不到用户 PATH，有两条路可走：
- 推荐长期方案：进「系统属性 → 高级 → 环境变量」，把 Node.js、Git、MinGW 的路径（如
C:UsersXXXAppDataRoaming 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"}——注意 Windows 用分号;拼接，路径中的反斜杠要双写 - 特别注意 PATH 长度：Windows 注册表对 PATH 有 2048 字符硬限制，超长会被截断；如果 PATH 里混着大量重复或废弃路径，可能直接失效
tasks.json / launch.json 里的命令也报 “command not found”
终端能跑 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字段
真正容易被忽略的是：即使你修好了终端 PATH，tasks.json 和 launch.json 仍需各自独立配置环境变量。它们不共享终端状态，也不继承 shell 初始化逻辑——这是设计使然，不是 bug。
