VSCode终端找不到npm的根本原因是其未加载shell环境变量PATH。macOS/Linux因非登录shell跳过配置文件，Windows则因权限问题无法继承环境变量；需检查系统终端中npm路径，将对应目录加入PATH并重启VSCode。
为什么 VSCode 终端里找不到 npm
根本原因不是 npm 没装，而是 VSCode 启动时没读到你的 shell 环境变量（比如 PATH）。macOS 和 Linux 下它默认用非登录 shell 启动终端，跳过了 ~/.zshrc 或 ~/.bash_profile；Windows 则常因 VSCode 以不同用户权限启动，导致无法继承系统或用户级环境变量。
检查 npm 是否真存在，以及它在哪
别急着重装 Node.js。先在系统原生终端（iTerm / Terminal / PowerShell）里运行：
which npm
或 Windows 上：
where npm
如果返回路径（如 /opt/homebrew/bin/npm 或 C:\Program Files\nodejs\npm.cmd），说明已安装。记下这个路径，后面要用。
- macOS/Linux：确认该路径是否已在 shell 配置文件中加入
PATH（例如export PATH="/opt/homebrew/bin:$PATH"） - Windows：检查「系统属性 → 高级 → 环境变量」里，
Path是否包含 Node.js 安装目录（如C:\Program Files\nodejs\） - VSCode 必须重启才能重新加载环境变量 —— 修改配置后不重启等于没改
让 VSCode 终端正确继承 PATH
VSCode 的内置终端依赖 terminal.integrated.defaultProfile.* 和 shell 启动方式。关键操作是强制它走登录 shell 或显式加载配置：
- macOS：打开 VSCode 设置（
Cmd + ,），搜索terminal.integrated.env.osx，添加键值对："PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"（把which npm返回的路径放最前） - Linux：同上，修改
terminal.integrated.env.linux，确保含npm所在目录 - Windows：检查
terminal.integrated.defaultProfile.windows是否为PowerShell或Command Prompt；若用 Git Bash，需确认其启动参数含--login（可在设置里加"terminal.integrated.profiles.windows"覆盖） - 通用兜底法：在 VSCode 中按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入并执行Developer: Restart TS Server不起作用，真正有效的是Developer: Reload Window
Node.js 安装方式影响 npm 可见性
用包管理器装的 Node.js（如 Homebrew、nvm、Chocolatey）比官网 .pkg/.msi 更容易出现路径隔离问题：
- nvm 用户：确保
nvm use已执行，且 VSCode 是从已激活 nvm 环境的终端里启动的（比如在 iTerm 里运行code .） - Homebrew 用户：避免混用
brew install node和官网安装包，后者会把npm放进/usr/local/bin，前者放在/opt/homebrew/bin，冲突时优先级取决于PATH顺序 - Windows 用户：官网安装包默认勾选「Add to PATH」，但如果当时勾了「仅限当前用户」，而 VSCode 是系统级启动的，就可能看不到——换用「所有用户」安装或手动补全环境变量
最隐蔽的坑：某些 macOS M1/M2 机器上，VSCode 自带的终端默认用 zsh，但你用的是 fish 或 bash，又没设好 shell 兼容层，PATH 就压根不会被读取。这时候与其硬调，不如直接在 VSCode 设置里指定 shell 路径，比如 "terminal.integrated.profiles.osx": { "zsh": { "path": "/bin/zsh" } }。
