Laravel Herd显示Node.js已安装，但终端无法识别npm/node命令求助

问题原因 #

Laravel Herd自带的Node.js是独立的本地环境，未添加到系统的**环境变量（PATH）**中，导致系统终端（CMD、VS Code终端）无法找到node和npm命令。

解决方法 #

1. 临时生效（单次终端会话） #

先找到Herd的Node安装路径：

• Windows：C:\Users\{你的用户名}\AppData\Roaming\Herd\bin（替换{你的用户名}为实际系统用户名）
• Mac/Linux：~/.config/Herd/bin

在终端执行对应命令添加临时路径：

• Windows CMD：

  set PATH=C:\Users\{你的用户名}\AppData\Roaming\Herd\bin;%PATH%
  

• Windows PowerShell：

  $env:PATH = "C:\Users\{你的用户名}\AppData\Roaming\Herd\bin;" + $env:PATH
  

• Mac/Linux：

  export PATH="$HOME/.config/Herd/bin:$PATH"
  

执行后即可在当前终端使用node -v、npm install等命令。

2. 永久生效（所有终端会话） #

Windows系统

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
2. 在「系统变量」列表中找到Path，点击「编辑」
3. 点击「新建」，粘贴Herd的Node路径：C:\Users\{你的用户名}\AppData\Roaming\Herd\bin
4. 依次点击「确定」保存所有设置，重启终端和VS Code后生效

Mac/Linux系统

1. 打开终端，编辑shell配置文件（比如~/.zshrc或~/.bashrc，根据你使用的shell选择）
2. 添加以下内容到文件末尾：

   export PATH="$HOME/.config/Herd/bin:$PATH"
   

3. 执行命令使修改立即生效：

   source ~/.zshrc  # 若用bash则执行 source ~/.bashrc
   

4. 重启终端和VS Code后，所有会话均可使用node和npm

3. 直接使用Herd内置终端 #

打开Laravel Herd，找到你的项目，点击「Open Terminal」——这个终端已经自动配置好Herd的Node环境，直接执行安装命令即可：

npm install tailwindcss @tailwindcss/vite

验证方法 #

设置完成后，打开新的终端窗口，执行以下命令：

node -v
npm -v

若能正常显示Node和npm的版本号，说明配置成功。

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