VSCode终端能运行npm但提示“找不到全局包”的根本原因是其启动时读取的PATH环境变量与手动终端不一致，常见于shell配置未加载、nvm初始化缺失或Windows用户级PATH未生效，需按层排查并重启VSCode。
VSCode 终端能运行 npm，但提示“找不到全局包”
根本原因是 VSCode 启动时读取的环境变量（尤其是 PATH）和你终端里手动启动的 shell 不一致——比如你在 zsh 里配置了 npm 全局 bin 路径（如 ~/.npm-global/bin），但 VSCode 可能以 login shell 模式没加载你的 ~/.zshrc，或者它用的是 bash 配置。
实操建议：
- 先确认当前 VSCode 终端里的
PATH：运行echo $PATH，看输出是否包含你的 npm 全局 bin 路径（比如/Users/xxx/.npm-global/bin或/usr/local/bin） - 如果缺失，别急着改 VSCode 设置，先检查 shell 是否被正确识别：在 VSCode 终端右下角点 shell 名称（如 “bash”），切换成你日常用的 shell（如
zsh） - 确保该 shell 的配置文件（
~/.zshrc、~/.bash_profile等）里有类似这行：export PATH="$HOME/.npm-global/bin:$PATH" - 改完后重启 VSCode（不是只关终端！必须完全退出再打开），否则环境变量不会重载
VSCode 内置终端识别不到 nvm 切换的 Node 版本
因为 nvm 是通过 shell 函数动态修改 PATH 和 NODE_VERSION 的，而 VSCode 启动时可能没执行 nvm 初始化脚本，导致它看到的还是系统默认 Node，进而找不到对应全局安装的包。
实操建议：
- 在 shell 配置文件末尾加上完整初始化代码（不只是
source ~/.nvm/nvm.sh）：export NVM_DIR="$HOME/.nvm"<br>[ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"<br>[ -s "$NVM_DIR/bash_completion" ] && . "$NVM_DIR/bash_completion"
- 避免使用
nvm use命令临时切换——VSCode 启动时不会执行它；改用nvm alias default 18.18.2固定默认版本 - 验证：重启 VSCode 后，在内置终端运行
which node和which npm，路径应指向~/.nvm/versions/node/...下的可执行文件
Windows 上 VSCode 提示“eslint not found”，但命令行能用
Windows 用户常见于：全局安装了 eslint（npm install -g eslint），CMD/PowerShell 能运行，但 VSCode 终端或编辑器集成提示报错。本质是 Windows 的 %APPDATA%
pm 路径没进 VSCode 的 PATH，尤其当 VSCode 是从开始菜单快捷方式启动时，它继承的是“系统级”环境变量，而非用户级。
实操建议：
- 查出 npm 全局 bin 实际位置：
npm config get prefix，然后拼上in（如C:UsersXXXAppDataRoaming pmin） - 把这个路径手动加进 Windows “用户环境变量” 的
PATH（不是系统 PATH），并重启 VSCode - 如果用了 pnpm，注意它默认把全局 bin 放在
%LOCALAPPDATA%pnpm，路径不同，别套用 npm 的逻辑 - 不推荐改 VSCode 的
terminal.integrated.env.windows设置来硬塞 PATH——容易和 shell 自身逻辑冲突，优先走系统环境变量修复
插件（如 ESLint、Prettier）仍报“找不到命令”，即使 PATH 正确
这类问题往往不是环境变量本身错了，而是 VSCode 插件默认不读取 shell 的 PATH，而是用自己启动时捕获的初始环境——哪怕你后来在终端里 export PATH=...，插件也不会感知。
实操建议：
- 对 ESLint 插件，优先配
eslint.packageManager（设为"npm"或"pnpm"），让它自动找本地node_modules/.bin/eslint，绕过全局依赖 - 如果必须用全局，设置
eslint.runtime指向你实际的 Node 路径（如"C:\Users\xxx\AppData\Roaming\nvm\v18.18.2\node.exe"），避免插件用错 runtime 导致模块解析失败 - 检查插件是否启用了工作区级配置：有些项目根目录有
.vscode/settings.json，里面写了"eslint.nodeEnv"或"eslint.options"，会覆盖用户级设置
最麻烦的其实是多层抽象叠加：shell 配置 → VSCode 启动方式 → 终端类型 → 插件运行时上下文。每层都可能截断 PATH 传递，所以别只盯着一个地方改。
