Laravel 10 & PHP 8.1执行npm run dev报错求助

安全阿岳

2026-6-21

解决npm run dev时找不到Herd/Valet配置文件的问题

错误信息

error when starting dev server:
Error: Unable to find the configuration file [C:\Users\LP-266\.config\herd\config\valet\config.json].
    at resolveDevelopmentEnvironmentTld (file:///C:/laragon/www/tenant-portal/node_modules/laravel-vite-plugin/dist/index.js:358:11)
    at resolveDevelopmentEnvironmentServerConfig (file:///C:/laragon/www/tenant-portal/node_modules/laravel-vite-plugin/dist/index.js:320:94)
    at config (file:///C:/laragon/www/tenant-portal/node_modules/laravel-vite-plugin/dist/index.js:39:50)
    at runConfigHook (file:///C:/laragon/www/tenant-portal/node_modules/vite/dist/node/chunks/dep-CzJTQ5q7.js:67013:25)
    at async resolveConfig (file:///C:/laragon/www/tenant-portal/node_modules/vite/dist/node/chunks/dep-CzJTQ5q7.js:66464:12)
    at async _createServer (file:///C:/laragon/www/tenant-portal/node_modules/vite/dist/node/chunks/dep-CzJTQ5q7.js:63048:18)
    at async CAC.<anonymous> (file:///C:/laragon/www/tenant-portal/node_modules/vite/dist/node/cli.js:735:20)

解决步骤

安装Laravel Herd：如果还没装Herd，直接安装它，安装过程会自动生成所需的config.json配置文件，完成后重启终端再执行npm run dev。
手动创建配置文件：若已安装Herd但文件缺失，按路径C:\Users\LP-266\.config\herd\config\valet\创建对应文件夹，然后新建config.json文件，填入基础配置：
```
{
  "tld": "test",
  "paths": []
}
```
重置Herd配置：打开Herd的设置界面，找到重置配置的选项，执行后重启Herd和终端。

手动指定Vite服务器配置：修改项目根目录的vite.config.js，绕过Valet配置检测，示例代码：

import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';

export default defineConfig({
  plugins: [
    laravel({
      input: ['resources/css/app.css', 'resources/js/app.js'],
      refresh: true,
      server: {
        host: 'localhost',
        port: 5173,
        tld: 'localhost'
      }
    }),
  ],
});