执行npm install -g grunt-cli后grunt命令找不到的解决求助

问题根源 #

你使用Volta管理Node.js环境，Volta会将全局安装的CLI工具可执行文件存放在自身的bin目录中，而该目录未被添加到系统PATH环境变量，导致bash无法找到grunt命令。

解决步骤 #

• 定位Volta的bin目录
  Volta的默认bin目录路径为：C:\Users\{你的用户名}\AppData\Local\Volta\bin，也可以在终端执行以下命令获取准确路径：

  volta which grunt-cli
  

  输出结果里grunt-cli.exe所在的目录就是需要添加的路径。

• 添加路径到系统PATH

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「用户变量」或「系统变量」中找到PATH变量，点击「编辑」
  3. 新增一条路径，填入刚才找到的Volta bin目录路径
  4. 保存所有设置，关闭并重新打开终端（必须重启终端才能让新的PATH生效）

• 验证修复效果
  重新打开终端后执行：

  grunt --version
  

  此时应该能正常输出grunt-cli的版本信息。

补充说明 #

Volta接管全局包管理后，不会将包存放在npm默认的C:\Users\{username}\AppData\Roaming\npm目录下，而是存在C:\Users\{username}\AppData\Local\Volta\tools\image目录中，这是Volta的正常行为，无需担心。

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