Laravel Jetstream安装报错：无法在Vite清单找到resources/css/app.css

这是Laravel + Jetstream项目中Vite资源构建相关的常见问题，按以下步骤排查解决：

• 安装前端依赖并构建静态资源
  新项目默认不会自动安装前端依赖，Vite的manifest文件需要构建后生成，在项目根目录执行命令：

  npm install
  npm run build
  

• 检查Vite配置文件
  确认vite.config.js中的资源入口配置正确，默认配置应包含resources/css/app.css和resources/js/app.js，示例配置如下：

  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,
          }),
      ],
  });
  

  若你的css文件路径有变动，同步修改此处的配置项。

• 清除Laravel缓存
  缓存可能导致资源路径读取异常，执行以下命令清理缓存：

  php artisan cache:clear
  php artisan view:clear
  php artisan config:clear
  

• 校验.env文件的APP_URL配置
  确保.env文件中的APP_URL与你实际访问项目的地址一致，比如：

  APP_URL=http://localhost/your-project/public
  

  地址不匹配会导致Vite无法正确定位资源文件。

• 开发环境使用Vite开发服务器
  如果你处于开发阶段，无需每次修改都执行npm run build，直接启动Vite开发服务器即可实时编译资源：

  npm run dev
  

  保持该命令窗口处于运行状态，再访问项目即可。

内容的提问来源于stack exchange，提问作者Özgür Çoban