MacOS 12.4 zsh终端npm全局包环境变量配置问题（已解决）

zsh 无法识别全局安装的 npm 包命令，核心原因是 npm 全局包的可执行文件所在目录没有被加入 zsh 的 PATH 环境变量，加上对 .zshrc 配置文件的操作方式有误，导致配置始终无法生效。

• 先确认 npm 全局包的安装前缀，终端执行以下命令：

  npm config get prefix
  

  记录返回的路径，官方 pkg 安装的 Node.js 在 Mac 上默认返回 /usr/local，如果你手动修改过全局安装路径（比如 /Users/vincent/.npm-global），以你自己的返回结果为准，后续需要用到该路径下的 bin 目录。
• 创建用户级 .zshrc 配置文件（文件不存在时才需要执行这步），终端直接运行：

  touch ~/.zshrc
  

  • 注意：执行这条命令不要加 sudo，.zshrc 是当前用户家目录下的个人配置文件，不需要管理员权限。如果之前创建文件时报 ENOTSUP 错误，先执行 echo $HOME 确认返回值为 /Users/vincent，如果返回值异常为 /home，先执行 export HOME=/Users/vincent 再重新创建文件。
• 将 npm 全局 bin 目录写入 PATH 配置，根据上一步拿到的 prefix 路径执行对应命令：
  如果 prefix 是 /usr/local，执行：

  echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc
  

  如果 prefix 是 /Users/vincent/.npm-global，执行：

  echo 'export PATH="/Users/vincent/.npm-global/bin:$PATH"' >> ~/.zshrc
  

• 让配置立即在当前终端生效，执行：

  source ~/.zshrc
  

• 验证配置是否生效，执行：

  vercel --version
  

  正常返回版本号即配置成功，VS Code 内的 zsh 终端重启后会自动加载该配置，可直接运行 vercel deploy 执行部署。

• 不要直接运行 ~/.zshrc：.zshrc 是 zsh 启动时自动加载的 Shell 配置脚本，不是可执行程序，手动加载配置必须使用 source ~/.zshrc 命令，直接运行必然报 command not found 或权限错误。
• 不要修改 /etc 路径下的系统级配置文件：个人用户的环境变量配置只需修改家目录下的 ~/.zshrc 即可，修改系统级文件容易触发权限问题，还可能影响设备上所有用户的 Shell 环境。
• PATH 配置格式不要写错：需要把可执行文件所在的目录加入 PATH，而非给单个命令设置自定义变量，否则 zsh 仍然无法识别命令。
• 如果 VS Code 终端配置不生效，打开 VS Code 设置搜索 terminal.integrated.env.osx，确认没有手动覆盖 PATH 配置项，重启 VS Code 即可正常加载配置。

内容的提问来源于stack exchange，提问作者Vincent Hus