通过Homebrew安装Node.js后，node/npm命令无法执行问题求助

你遇到的情况大概率是环境变量PATH没包含Homebrew安装的Node.js路径导致的，下面是一步步的实操解决方法：

第一步：确认Homebrew安装Node的位置 #

先执行这条命令，找到Homebrew把Node安装的具体路径：

brew --prefix node

• Intel芯片Mac的输出一般是 /usr/local/opt/node
• Apple Silicon（M系列）芯片Mac的输出通常是 /opt/homebrew/opt/node

第二步：检查PATH里是否包含Node的bin目录 #

执行这条命令查看当前的PATH配置：

echo $PATH

看看输出里有没有上面路径拼接/bin的结果（比如Intel的是/usr/local/opt/node/bin，Apple Silicon的是/opt/homebrew/opt/node/bin）。如果没看到这个路径，就需要手动添加。

第三步：把Node的bin目录添加到PATH里 #

根据你使用的shell（bash或zsh），修改对应的配置文件：

如果你用的是bash： #

1. 打开bash的配置文件（没有.bash_profile就用.bashrc）：

nano ~/.bash_profile

2. 在文件末尾添加对应芯片的配置行：
   • Intel Mac：

     export PATH="/usr/local/opt/node/bin:$PATH"
     

   • Apple Silicon Mac：

     export PATH="/opt/homebrew/opt/node/bin:$PATH"
     

3. 按Ctrl+O保存，Ctrl+X退出编辑器
4. 让配置立即生效：

source ~/.bash_profile

如果你用的是zsh（当前Mac默认shell）： #

1. 打开zsh的配置文件：

nano ~/.zshrc

2. 同样在末尾添加对应芯片的PATH配置，保存退出后执行：

source ~/.zshrc

第四步：修复可能的链接冲突 #

如果添加PATH后还是不行，试试让Homebrew重新链接Node：

brew link node

如果提示有冲突需要覆盖，执行：

brew link --overwrite node

第五步：清除shell命令缓存 #

有时候shell会缓存旧的命令路径，执行这条命令清除缓存：

hash -r

现在再试试node -v和npm -v，应该就能正常显示版本号了。

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