如何配置多级嵌套路由?解决三级菜单下 router-view 渲染失效的痛点

秋萱同学_1263

秋萱同学_1263

2026-06-02

1119人浏览

原创

本质是每层有子路由的组件都必须包含作为渲染容器,否则子路由无处挂载;一级布局组件需含,二级组件若配children也须添加,且子路由path不能以斜杠开头,须严格匹配层级。

如何配置多级嵌套路由?解决三级菜单下 router-view 渲染失效的痛点

多级嵌套路由配置失效,本质不是路由写错了,而是<router-view></router-view>没出现在该出现的位置——每一层有子路由的组件,都必须自己提供一个渲染容器。

父级布局组件必须含 router-view

一级路由(如 /system)对应的组件(如 SystemLayout.vue)不能只是空壳页面。它要承担布局职责:顶部栏、侧边菜单、内容区。其中内容区必须包含 <router-view></router-view>,否则所有子路由组件都没地方挂载。

  • 错误写法:组件模板里只有 <el-header></el-header><el-aside></el-aside>,漏掉 <router-view></router-view>
  • 正确写法:在主体内容区域明确插入 <router-view></router-view>,位置通常在侧边栏之后、页脚之前
  • 若依等后台框架中,常见于 views/system/index.vue 或自定义的 Layout.vue 文件内

二级路由组件也要有 router-view

当菜单层级达到三级(例如 /system/log/online),路径结构是:一级 → 二级 → 三级。这意味着二级路由组件(如 views/system/log/index.vue)本身也承载子路由,它同样需要 <router-view></router-view> 来渲染三级页面。

MusicAI
MusicAI

一款AI音频处理工具,主要用于AI音乐生成工具,适合需要提升相关任务效率的用户。

下载
  • 不要以为“二级组件只展示表格或列表就够了”,只要它下面还配了 children,就必须加容器
  • 典型结构:<div class="app-container">... <router-view></router-view> </div>
  • 若用的是若依框架,index.vue 文件名是硬性约定,不能改成 LogList.vue 后就忽略容器逻辑

路由配置需严格匹配路径层级

路径字符串的书写规则直接影响匹配结果。子路由的 path 值不加开头斜杠,是嵌套路由生效的前提。

  • 一级路由:path: '/system'
  • 二级路由(在 children 中):path: 'log' → 实际访问地址为 /system/log
  • 三级路由(二级的 children 中):path: 'online' → 实际为 /system/log/online
  • 切忌写成 path: '/log' 或 path: '/online',这会导致路由无法嵌套,直接跳到根路径下匹配,造成白屏

确保每个路由级都有对应 component

Vue Router 是逐层查找的:先找到一级 component,再在其内部找二级,再找三级。任意一层 component 未定义或路径导入错误,后续层级全部中断。

  • 检查 import 路径是否准确,大小写、文件后缀(.vue)、文件是否存在都要确认
  • 在路由配置中,每个 children 数组里的对象都必须带 component 字段,不能遗漏
  • 调试技巧:在 Chrome Vue Devtools 中观察当前激活的路由和已创建的组件实例,看哪一层 component 没被实例化

相关文章

路由优化大师
路由优化大师

路由优化大师是一款及简单的路由器设置管理软件,其主要功能是一键设置优化路由、屏广告、防蹭网、路由器全面检测及高级设置等,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

vue router

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

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

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

2023.08.11

2343

5

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

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

2023.10.09

5043

6

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

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

2024.03.19

6130

13

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

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

2024.03.22

5658

10

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

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

2024.05.22

803

5

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.17

1654

5

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

11922

5

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

2026.02.10

296

23

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app电商系统实战精讲课程
uni-app电商系统实战精讲课程

共66课时 | 17.5万人学习

Vue实战—打造属于自己的外卖系统
Vue实战—打造属于自己的外卖系统

共82课时 | 15.6万人学习

Vue核心技术实战教程全套完整版
Vue核心技术实战教程全套完整版

共75课时 | 12.2万人学习