Laravel项目中使用Vite可提升前端编译效率，相比Laravel Mix启动更快、热更新更迅速；从Laravel 9.x起默认集成Vite，需安装vite及对应插件如@vitejs/plugin-vue，并配置vite.config.js文件设置别名、输出路径和开发服务器；通过@vite指令在Blade模板中引入资源，实现开发与生产环境的无缝切换。
在 Laravel 项目中使用 Vite 进行前端资源编译，相比传统的 Laravel Mix（基于 Webpack）更加高效和现代化。Vite 利用原生 ES 模块和浏览器支持，实现了更快的开发服务器启动和热更新。以下是 Laravel 中配置和使用 Vite 的完整指南。
安装与初始化 Vite
从 Laravel 9.x 开始，新项目默认使用 Vite。如果你的项目还未配置，可以手动安装：
- 运行命令安装 Vite 及相关依赖：
npm install --save-dev vite @vitejs/plugin-vue @vitejs/plugin-react - 安装 Laravel 提供的 Vite 辅助包：
composer require tightenco/ziggy（可选，用于路由生成） - 创建 vite.config.js 配置文件
配置 vite.config.js
在项目根目录创建 vite.config.js，根据你使用的前端框架（如 Vue、React 或纯 JavaScript）进行配置。
例如，使用 Vue 3 的配置如下：
import { defineConfig } from 'vite';
import vue from '@vitejs/plugin-vue';
import path from 'path';
export default defineConfig({
plugins: [vue()],
resolve: {
alias: {
'@': path.resolve(__dirname, 'resources/js'),
},
},
build: {
outDir: 'public/build',
emptyOutDir: true,
manifest: true,
},
publicDir: 'public',
server: {
host: 'localhost',
port: 5173,
hmr: {
host: 'localhost',
},
},
});
关键点说明：
立即学习“前端免费学习笔记（深入）”；
shopify-app-react-router
下载
构建 Shopify 嵌入式应用（Embedded App）的开发技能：基于 @shopify/shopify-app-react-router + React Router v7 + Admin API 2026-04。覆盖 shopifyApp 配置、authenticate.admin 的 GraphQL/REST 调用、Webhook 校验、Session 存储、订阅计费、App Bridge 导航、部署，并新增：适用场景判断、安全最佳实践、错误处理与容错、最佳实践、常见问题 FAQ、高级场景。G
- alias：设置路径别名，方便 JS/TS 中导入组件
- build.outDir：编译后文件输出到 public/build
- server.host/port：开发服务器地址
Laravel 模板中引入资源
Laravel 提供了 @vite 指令来加载开发或生产环境下的资源文件。
在 Blade 模板中使用：<@vite(['resources/js/app.js', 'resources/css/app.css'])
该指令会自动判断环境：
- 开发模式下，引入 Vite 开发服务器（http://localhost:5173）的资源
- 生产模式下，加载构建后的 CSS 和 JS 文件（通过 manifest.json 查找）
运行开发与构建命令
在 package.json 中配置常用脚本：
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
}
常用命令：
- npm run dev：启动 Vite 开发服务器，支持热重载
- npm run build：编译资源到 public/build 目录
- npm run preview：预览生产构建效果
基本上就这些。Laravel + Vite 的组合让前端开发更轻快，配置清晰，适合现代 JS 框架集成。注意确保 .env 中的 APP_URL 与 Vite 开发服务器能正常通信，避免跨域问题。不复杂但容易忽略。
