laravel 9.19+ 官方集成 vite,替换 Laravel Mix,通过 vite.config.js 配置入口与热更新,Blade 中用 @vite() 替代 mix(),支持 css/postcss/Tailwind,npm run dev/build 实现快速开发与构建。

在 Laravel 中使用 Vite 进行前端资源打包,核心是替换掉旧的 Laravel Mix,利用 Vite 的原生 ES 模块支持和极速热更新能力。Laravel 9.19+ 已官方集成 Vite,只需少量配置即可启用。
初始化 Vite 配置
新项目默认已含 Vite 支持;老项目需手动安装并配置:
import { defineConfig } from 'vite'; import laravel from 'laravel-vite-plugin'; <p>export default defineConfig({ plugins: [ laravel({ input: ['resources/css/app.css', 'resources/js/app.js'], refresh: true, }), ], });
其中 input 指定要编译的入口文件,refresh 启用组件热更新(适用于 Inertia / Livewire)。
更新 Blade 模板引入方式
不再使用 mix(),改用 @vite() 指令:
立即学习“前端免费学习笔记(深入)”;
<!-- resources/views/app.blade.php --> @vite(['resources/css/app.css', 'resources/js/app.js'])
开发时自动注入 HMR 脚本;构建后生成带哈希的静态资源链接,无需额外处理。
处理 CSS 与 PostCSS(可选但推荐)
Vite 默认支持 CSS、PostCSS 和 sass。如需 Tailwind 或自定义前缀:
- 确保已安装 postcss 和 autoprefixer
- 在 postcss.config.js 中配置:
module.exports = { plugins: { tailwindcss: {}, autoprefixer: {}, }, };
Tailwind 用户还需在 resources/css/app.css 中加入 @tailwind base; @tailwind components; @tailwind utilities;。
构建与部署
开发与构建命令如下:
- 开发服务器:
npm run dev(启动 Vite 开发服务,自动代理到 Laravel) - 生产构建:
npm run build(输出到public/build/,自动更新引用) - 预览生产包:
npm run preview
构建后资源路径由 Vite 自动管理,@vite() 会读取 manifest.json 确保正确加载哈希文件。
基本上就这些。Vite 在 Laravel 中开箱即用,配置轻量、启动快、热更准,适合现代前端工作流。