MacOS系统npm安装全局包后执行命令提示找不到的问题求助

问题根源 #

你遇到的问题核心是zsh未正确加载npm全局安装路径的环境变量，同时存在配置文件递归加载的错误，另外不需要修改系统分区的软链接，Mac 10.15+ 系统分区默认只读，该操作本身不可行。

分步解决步骤 #

1. 修复.profile配置错误
   打开~/.profile文件，删除里面的source ~/.profile行，修改后仅保留以下内容：

   export PATH=~/.npm-global/bin:$PATH
   

   这行source ~/.profile会导致配置文件递归加载，属于完全无效的错误配置。

2. 修正.zshrc的环境变量配置
   打开~/.zshrc文件，做两处修改：

   • 删除重复的source /Users/mac/.bash_profile行，保留1次即可
   • 在文件末尾新增一行：source ~/.profile，也可以直接新增export PATH=~/.npm-global/bin:$PATH
     原因是zsh作为默认shell时，默认不会主动加载.profile配置，你之前设置的npm全局路径只写在了.profile里，zsh根本读不到。

3. 修复全局包目录权限（可选，避免后续装全局包要加sudo）
   执行命令：

   sudo chown -R $(whoami) ~/.npm-global
   

4. 重新加载配置生效
   执行命令：

   source ~/.zshrc
   

5. 验证是否修复
   先执行echo $PATH，确认输出中包含/Users/mac/.npm-global/bin路径，再执行yarn --version即可正常返回版本号。

注意：不需要再尝试创建/usr/bin下的软链接，也不需要关闭系统完整性保护（SIP），立刻把SIP恢复开启，避免系统安全风险。

内容的提问来源于stack exchange，提问作者Jesse Marques