Laravel怎么引入Vite编译_Laravel如何管理前端资源【教程】

尼克

尼克

2026-04-29

754人浏览

原创

vite 在 laravel 中需替换 mix 而非共存,须删除 webpack.mix.js、禁用 mix 并配置 vite.config.js 与 config/vite.php 对齐 build.outdir 和 manifest;blade 必用 @vite 指令以支持 hmr 与哈希资源加载,缺 manifest.json 将导致白屏或缓存错误。

laravel怎么引入vite编译_laravel如何管理前端资源【教程】

Vite 在 Laravel 里不是“引入”而是“替换”——你得关掉 Mix,删掉 webpack.mix.js,否则两个构建工具会抢资源、爆缓存、热更新失灵。

怎么让 Laravel 用上 vite build 的产物

核心是把 vite build 输出的静态文件路径,对齐到 Laravel 的 public/ 目录,并让 Blade 正确加载哈希后的资源。

  • 运行 vite build 后,默认生成到 public/build/(由 vite.config.js 中的 build.outDir 控制),Laravel 的 @vite 指令默认也找这里
  • Blade 中必须用 @vite(['resources/js/app.js']),不能手写 <script src="..."></script> —— 否则开发时 HMR 失效,生产时无法注入哈希
  • 如果改过 build.outDir(比如改成 public/assets),就得同步在 vite.config.js 里配 build.manifest: true,并在 config/vite.php 中加 'build_directory' => 'assets'

@vite 指令背后到底做了什么

它不是简单插入 script 标签,而是在开发和生产环境下做两套事:开发时注入 Vite 开发服务器的 WebSocket 连接,生产时从 manifest.json 查真实文件名(含 hash)。

面向设计的AXUI前端框架表单
面向设计的AXUI前端框架表单

面向设计的AXUI前端框架表单是一款包含表格、列表、弹窗等的AXUI前端框架表单下载。

下载
  • 开发时:@vite 会输出类似 <script type="module" src="http://localhost:5173/@vite/client"></script> + 入口脚本,依赖本地 Vite 服务运行
  • 生产时:必须先跑 vite build 生成 manifest.json@vite 才能读取并替换为带 hash 的路径,例如 assets/app.8a2f3bdc.js
  • 如果部署后页面白屏且控制台报 Failed to fetch dynamically imported module,大概率是 manifest.json 没生成、路径不对,或没上传到服务器

为什么 mix 和 vite 不能共存

它们都监听 resources/js/,都试图往 public/ 写文件,但策略完全不同:Mix 硬拷贝 + 时间戳,Vite 用哈希 + manifest 映射。冲突点集中在缓存、热更新、CDN 路径这几块。

  • 删除 webpack.mix.jsnode_modules/.bin/mix,卸载 laravel-mix 相关包(保留 laravel-vite-plugin
  • npm run dev 必须指向 vite(检查 package.json"scripts": {"dev": "vite"}
  • 旧项目迁移时,别忘了清空 public/mix-manifest.jsonpublic/js/public/css/ 下 Mix 产出的文件,否则 Nginx/Apache 可能优先命中旧资源

最常被跳过的一步:改完配置后没跑 vite build 就直接上线,结果页面加载的是未哈希的开发版 JS,缓存炸了还查不出问题。Vite 的产物路径和加载逻辑全靠 manifest.json 绑定,缺它就等于没编译完成。

前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1109

5

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

2023.10.09

2261

6

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

2024.03.19

2130

13

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

2024.03.22

2301

10

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

2024.05.22

336

5

laravel组件介绍
laravel组件介绍

laravel 提供了丰富的组件,包括身份验证、模板引擎、缓存、命令行工具、数据库交互、对象关系映射器、事件处理、文件操作、电子邮件发送、队列管理和数据验证。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

672

10

laravel中间件介绍
laravel中间件介绍

laravel 中间件分为五种类型:全局、路由、组、终止和自定。想了解更多laravel中间件的相关内容,可以阅读本专题下面的文章。

2024.04.09

648

9

laravel使用的设计模式有哪些
laravel使用的设计模式有哪些

laravel使用的设计模式有:1、单例模式;2、工厂方法模式;3、建造者模式;4、适配器模式;5、装饰器模式;6、策略模式;7、观察者模式。想了解更多laravel的相关内容,可以阅读本专题下面的文章。

2024.04.09

1112

10

thinkphp和laravel哪个简单
thinkphp和laravel哪个简单

对于初学者来说,laravel 的入门门槛较低,更易上手,原因包括:1. 更简单的安装和配置;2. 丰富的文档和社区支持;3. 简洁易懂的语法和 api;4. 平缓的学习曲线。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.04.10

1568

7

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
如何安装 Composer
如何安装 Composer

共1课时 | 132人学习

Composer手册
Composer手册

共0课时 | 0人学习