根本原因是npm全局安装的可执行文件路径未加入系统PATH环境变量；需先运行npm config get prefix获取全局路径（如Windows为C:Users{user}AppDataRoaming pm，macOS/Linux为/usr/local），再将该路径下的bin子目录添加到PATH中，Windows通过系统环境变量配置，macOS/Linux在~/.zshrc或~/.bash_profile中添加export PATH="$(npm config get prefix)/bin:$PATH"并source生效，最后必须重启VSCode使集成终端加载新PATH。
npm install -g 命令没生效，终端报 command not found
根本原因不是 VSCode 本身的问题，而是全局安装的包可执行文件路径没进系统 PATH。Node.js 安装时自带 npm，但默认全局安装位置（如 C:Users{user}AppDataRoaming
pm）未必被 Windows 或 macOS 的 shell 自动识别。
- 先在系统终端（非 VSCode）运行
npm config get prefix，确认当前全局路径；常见值是C:Users{user}AppDataRoaming pm（Windows）或/usr/local（macOS，默认需 sudo） - 把这个路径手动加进系统环境变量：
Windows：系统属性 → 高级 → 环境变量 → 用户变量/系统变量的PATH里新增该路径
macOS/Linux：在~/.zshrc或~/.bash_profile中追加export PATH="$(npm config get prefix)/bin:$PATH" - 改完后，**必须重启 VSCode**（不是只关终端），否则集成终端仍读不到新
PATH
VSCode 终端里能运行 npm，但跑不了 webpack 或 eslint
说明 npm install -g webpack 成功了，但 VSCode 没加载到全局 bin 目录。尤其常见于使用 PowerShell 或 zsh 且未启用 login shell 的情况。
- 在 VSCode 终端里执行
which webpack（macOS/Linux）或where webpack（Windows），如果返回空，就是路径没生效 - 打开 VSCode 设置，搜
terminal.integrated.profiles，找到你用的 shell（比如zsh或powershell），给它加上"args": ["-l"]（-l表示 login mode，会加载 profile） - 或者更直接：在 VSCode 终端里手动运行
source ~/.zshrc（macOS/Linux）或. $PROFILE（PowerShell），再试webpack -v
全局安装后，VSCode 任务（tasks.json）仍提示 command not found
VSCode 的 tasks 系统不走 shell alias，也不自动继承 shell profile，它只查原始 PATH 环境变量。哪怕你在终端里能跑通，tasks 里照样失败。
- 不要写
"command": "webpack"，改成绝对路径，比如："command": "/Users/you/.nvm/versions/node/v20.15.0/bin/webpack"（macOS）"command": "C:\Users\you\AppData\Roaming\npm\webpack.cmd"（Windows） - 更稳妥的做法：在
tasks.json里显式指定env字段，补全PATH："env": { "PATH": "C:\Users\you\AppData\Roaming\npm;${env:PATH}" } - 注意：Windows 上全局安装的 CLI 工具实际是
.cmd文件，不是.js，别漏掉后缀
想换淘宝镜像加速，但 npm config set registry 不生效
配置可能被项目级 .npmrc 或用户级 .npmrc 覆盖，尤其是用了 nvm 或 corepack 时。
- 运行
npm config list -l查看所有生效配置源，重点关注registry出现在哪一级（global、user还是project） - 强制设全局镜像：
npm config set registry https://registry.npmmirror.com --global（注意加--global） - 如果用了 pnpm，它有自己的镜像设置方式：
pnpm config set registry https://registry.npmmirror.com，和 npm 互不影响 - 验证是否生效：运行
npm view lodash version，响应快且没超时，基本就对了
真正卡住人的地方，往往不是命令敲错，而是全局 bin 路径没进 shell 初始化流程，或者 VSCode 启动方式绕过了 profile 加载。每次改完环境变量或 npm config，记得关掉所有 VSCode 实例再重开——这点最容易被跳过。
