MacOS下执行npm包命令始终提示‘command not found’求助

我之前也碰到过完全一样的情况，重装Node/npm好几次都没用，最后发现是系统PATH配置或者权限的问题，给你几个一步步的排查和修复步骤：

1. 先确认npm全局包的安装路径 #

首先运行这个命令，找到npm全局安装的根目录：

npm config get prefix

正常情况下，输出会是/usr/local（系统级安装）或者~/.npm-global（用户级自定义路径）。对应的全局命令的位置是这个路径下的bin目录，比如/usr/local/bin或者~/.npm-global/bin。

2. 检查这个路径是否在系统PATH里 #

运行以下命令查看当前的PATH配置：

echo $PATH

看看输出里有没有刚才找到的bin路径。如果没有，这就是问题所在——系统找不到npm安装的全局命令的位置。

临时修复（重启终端后失效） #

直接在终端里执行以下命令，把路径临时加到PATH里（替换成你自己的bin路径）：

export PATH=$PATH:/usr/local/bin
# 或者如果你的prefix是~/.npm-global，就用下面这个
# export PATH=$PATH:~/.npm-global/bin

然后试试运行live-server，如果能正常执行，说明就是PATH的问题，接下来做永久配置。

永久修复 #

MacOS现在默认用的是Zsh，如果你用的是Bash，对应修改.bash_profile或.bashrc即可：

1. 打开你的shell配置文件：

   # Zsh用户
   open ~/.zshrc
   # Bash用户
   open ~/.bash_profile
   

2. 在文件末尾添加一行（替换成你的bin路径）：

   export PATH=$PATH:/usr/local/bin
   

3. 保存文件后，运行以下命令让配置生效：

   # Zsh用户
   source ~/.zshrc
   # Bash用户
   source ~/.bash_profile
   

3. 检查权限问题 #

如果PATH已经配置正确，但还是找不到命令，可能是全局包的目录或文件没有执行权限：

1. 先确认live-server的安装位置：

   npm list -g live-server
   

2. 查看该文件的权限：

   ls -l /usr/local/bin/live-server
   # 替换成你实际的路径
   

   看输出的权限列（比如-rwxr-xr-x），如果没有x（执行权限），运行以下命令添加：

   chmod +x /usr/local/bin/live-server
   

4. 重置npm全局前缀（避免权限冲突） #

有时候系统级的/usr/local目录权限会有问题，你可以把npm的全局安装路径改成用户目录下的路径：

1. 设置新的全局前缀：

   npm config set prefix ~/.npm-global
   

2. 按照步骤2的方法，把~/.npm-global/bin加到你的PATH里（永久配置）。
3. 重新全局安装live-server：

   npm install -g live-server
   

5. 最后验证 #

运行以下命令，确认node和npm的路径都正常：

which node
which npm
which live-server

如果三个命令都能返回有效路径，说明问题已经解决了。

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