VSCode终端找不到npm是因为未完整加载系统shell环境变量；macOS/Linux需启用login shell（设terminal.integrated.shellArgs为["-l"]），Windows应避免管理员模式运行并确保PATH包含Node.js路径。
VSCode 终端里运行 npm 报 “command not found” 或 “无法识别的内部或外部命令”，根本不是 VSCode 的问题，而是它没继承到你系统里已有的 npm 路径 —— 本质是 shell 环境变量没加载全。
为什么 VSCode 终端找不到 npm，但终端软件（如 iTerm、Terminal、CMD）可以？
VSCode 默认启动终端时，不会完整加载你的 shell 配置文件（比如 ~/.zshrc、~/.bash_profile 或 Windows 的用户环境变量），尤其在 macOS/Linux 下常跳过登录 shell 流程；Windows 则常见于 VSCode 没以当前用户权限启动，或用了旧版 PowerShell 启动器导致 PATH 未同步。
实操建议：
- macOS/Linux：检查 VSCode 是否启用了“login shell”——在设置里搜
terminal.integrated.shellArgs，把值设成["-l"]（注意是小写 L），重启终端 - Windows：优先改用
Command Prompt或新版Windows PowerShell（非旧版 PowerShell 5.1 的“PowerShell (x86)”），并在设置中确认terminal.integrated.defaultProfile指向正确 profile - 通用验证法：在 VSCode 终端里运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），对比系统终端输出，缺了node_modules/.bin或 Node.js 安装路径（如/usr/local/bin、C:\Program Files\nodejs\）就坐实是环境变量没继承
npm 路径明明存在，但 VSCode 重启后还是不生效
常见于 Node.js 是通过包管理器（如 brew、choco、nvm）安装，而这些工具的路径动态注入依赖 shell 启动方式，VSCode 不走 login 流程就漏掉。
立即学习“前端免费学习笔记（深入）”；
实操建议：
- macOS +
nvm：确保nvm初始化代码（类似export NVM_DIR="$HOME/.nvm"和[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"）放在~/.zshrc（不是~/.zprofile）里，并确认 VSCode 使用的是 zsh（查echo $SHELL） - Windows +
nvm-windows：必须手动把nvm目录（如C:\Users\XXX\AppData\Roaming\nvm）和当前激活的 Node 版本路径（如C:\Program Files\nodejs）加进系统环境变量PATH，不能只靠nvm use临时生效 - 所有平台：避免在 VSCode 设置里硬编码
terminal.integrated.env手动拼 PATH，容易覆盖原有变量；真要补，用"terminal.integrated.env.os": { "PATH": "${env:PATH}:/your/custom/path" }这种追加写法
改完配置，新开终端仍报错：找不到 node，连带 npm 也挂了
npm 是随 Node.js 一起安装的二进制，如果 node 都找不到，说明整个 Node.js 安装路径没进 PATH，或者安装被中断/损坏。
实操建议：
- 先在系统终端运行
which node（macOS/Linux）或where node（Windows），拿到真实路径；再确认该路径是否已在 VSCode 终端的PATH中 - macOS 用
brew install node安装的，路径通常是/opt/homebrew/bin/node（Apple Silicon）或/usr/local/bin/node（Intel），对应目录必须出现在PATH - Windows 用户特别注意：Node.js 官网安装包默认勾选 “Add to PATH”，但如果当时没用管理员权限运行安装程序，可能只写入了当前用户的 PATH，而 VSCode 若以系统级权限启动（比如从开始菜单右键“以管理员身份运行”），就看不到用户 PATH —— 关闭管理员模式重开 VSCode 即可
真正卡住人的地方，往往不是哪步操作错了，而是 VSCode 终端和系统终端看似一样，实则加载的 shell 生命周期不同；修环境变量不是配一次就完事，得盯住 $PATH 输出、确认 Node.js 安装路径、再核对 VSCode 用的是哪个 shell 和 profile —— 少一环，npm 就继续隐身。
