You need to enable JavaScript to run this app. 如何配置Vue 3 + Laravel 8 并在Blade模板中使用Vue单文件组件
优惠活动
大模型
产品
解决方案
定价
更多

如何配置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配置

前端代码结构搭建

  • 按照以下结构创建前端资源文件:
    • 在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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.31 04:06:10