如何配置Vue 3 + Laravel 8 并在Blade模板中使用Vue单文件组件
Laravel 8 Blade 集成Vue3单文件组件可落地方案
前置清理
- 全局安装Vue CLI的操作属于冗余步骤,之前出现的
Vue command not found报错完全不影响最终集成,无需额外排查修复 - 删除之前独立创建的Vue项目目录,避免和现有Laravel项目的依赖冲突
本地依赖安装
- 在Laravel项目根目录下执行本地依赖安装,禁止全局安装相关包:
npm install vue@next @vue/vue3-loader
注:之前出现的「Vue could not be resolved」报错,本质是仅安装了vue核心包,没有安装单文件组件所需的解析依赖,且没有在Laravel Mix中启用对应规则
编译规则配置
- 修改根目录下的
webpack.mix.js文件,启用Vue3的单文件解析支持,替换原有配置为:mix.js('resources/js/app.js', 'public/js') .vue({ version: 3 });- 如果你的入口js文件存放在自定义路径(比如
resources/assets/js/main.js),只需要把mix.js的第一个参数替换为实际路径即可 - 配置中的
.vue({ version: 3 })参数是Laravel Mix 6+内置的Vue支持开关,会自动完成vue-loader的规则匹配,无需手动编写复杂的webpack配置
- 如果你的入口js文件存放在自定义路径(比如
前端代码结构搭建
- 按照以下结构创建前端资源文件:
- 在
resources/js/目录下新建components文件夹,用于存放所有.vue单文件组件 - 入口文件
resources/js/app.js写入以下代码:import { createApp } from 'vue' import App from './components/App.vue' // 挂载选择器需要和Blade模板中的DOM元素id完全匹配 createApp(App).mount('#app')
- 在
- 可正常在
components目录下编写任意Vue3单文件组件,比如App.vue、UserList.vue等,支持任意组件的嵌套引用
Blade模板集成
- 在任意Blade模板中按以下方式引入即可,完全复用Laravel的路由体系,不存在跨端口、跨服务的问题:
<body> <!-- 挂载Vue的容器,id必须和JS中的mount选择器一致 --> <div id="app"> <!-- Vue根组件会自动渲染到该容器内 --> </div> <!-- 引入编译后的前端资源 --> <script src="{{ mix('js/app.js') }}"></script> </body>
运行验证
- 本地开发时执行
npm run watch,即可自动监听文件变动、实时编译资源,和Blade页面的开发流程完全一致 - 线上生产构建执行
npm run prod,编译产物会自动输出到public/js目录下,可直接通过Laravel的静态资源访问规则调用
常见问题修正
- 无需依赖laravel/ui包:上述配置步骤完全可以替代laravel/ui的适配功能,遇到laravel/ui适配失败的问题无需纠结,跳过手动配置即可
- 禁止使用npx创建独立Vue项目的方案:独立Vue项目属于前后端分离架构,和Blade内嵌组件的使用场景完全不匹配
- 若仍出现单文件解析错误,检查vue-loader版本:必须使用
@vue/vue3-loader,旧版vue-loader@15不支持Vue3的单文件组件语法
内容的提问来源于stack exchange,提问作者NewUser
相关产品推荐
相关产品推荐

