Mac终端执行eslint --init提示“command not found”的原因排查

我来帮你排查下这个常见问题，全局安装Node包后找不到命令的情况在Mac上挺普遍的，主要有这几个可能的原因和对应的解决办法：

1. Node.js全局bin目录未加入系统PATH #

npm全局安装的可执行文件（比如eslint）默认会放在Node的全局bin目录里，但如果这个目录没被添加到系统的PATH环境变量中，终端就找不到它。

• 先检查你的PATH里有没有Node全局bin目录：
  在终端执行：

  echo $PATH
  

  Mac上常见的Node全局bin路径是/usr/local/bin（官方安装包）或者~/.nvm/versions/node/<你的Node版本>/bin（nvm安装的Node）。

• 如果没找到对应的路径，就把它添加到终端配置文件里：

  • 如果你用的是bash，编辑~/.bash_profile文件：

    open ~/.bash_profile
    

    添加一行：

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

    保存后执行source ~/.bash_profile让配置生效。

  • 如果是Mac默认的zsh终端，编辑~/.zshrc文件：

    open ~/.zshrc
    

    同样添加上述PATH配置，然后执行source ~/.zshrc生效。

2. 使用nvm管理Node版本导致全局包路径不匹配 #

如果你用nvm来管理多个Node版本，全局安装的eslint只会绑定到当前激活的Node版本上。当你切换Node版本后，新的版本目录里没有安装eslint，自然就找不到命令了。

解决办法：

• 切换到你常用的Node版本，重新安装eslint：

  nvm use <你的常用版本号>
  npm install -g eslint
  

• 或者设置这个版本为默认版本，每次打开终端都会自动激活它：

  nvm alias default <你的常用版本号>
  

3. 安装时权限不足导致ESLint未正确安装 #

Mac系统下，默认的全局npm目录可能需要管理员权限才能写入，如果直接执行npm install -g eslint没有权限，可能会静默安装失败，或者安装到了用户目录但PATH没包含该路径。

更安全的解决方式是配置npm的全局目录到用户权限范围内：

1. 创建用户专属的npm全局目录：

   mkdir ~/.npm-global
   

2. 配置npm使用这个目录：

   npm config set prefix '~/.npm-global'
   

3. 把这个目录的bin路径添加到终端配置文件（bash_profile或zshrc）：

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

4. 重新加载配置并安装eslint：

   source ~/.bash_profile # 或者source ~/.zshrc
   npm install -g eslint
   

4. 终端会话未刷新配置 #

有时候你修改了PATH配置，但没有重新加载配置文件，或者新开一个终端窗口才能生效。试试关闭当前终端窗口，重新打开一个新窗口，再执行eslint --version看看能不能找到命令。

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