Vue / 系统课时
组织嵌套路由
组织嵌套路由
本节把管理后台的模块页组织成清晰的父子路由:父路由负责挂载后台布局,子路由负责渲染具体页面,并通过默认跳转让访问模块根路径时自动进入指定子页面。完成后,你可以独立配置两级以上的后台页面结构。
学习目标
- 理解父级布局、子路由和
<RouterView />的配合关系。 - 使用相对路径配置模块页面与默认跳转。
- 能通过地址栏和路由匹配结果验证嵌套路由。
设计父子路由关系
嵌套路由不是单纯把配置对象放进 children。当浏览器访问 /system/users 时,Vue Router 会同时匹配 /system 和它的子路由 users:父记录先渲染后台布局,布局中的 <RouterView /> 再渲染用户列表页。

父组件如果没有路由出口,子路由虽然能够匹配,但页面不会出现。后台布局至少要保留一个 <RouterView />,侧边栏、顶部栏等公共区域则放在出口之外。
<!-- src/layouts/AdminLayout.vue -->
<script setup lang="ts">
import { RouterView } from 'vue-router'
</script>
<template>
<div class="admin-layout">
<aside>后台导航</aside>
<main>
<!-- 当前命中的子页面会渲染在这里 -->
<RouterView />
</main>
</div>
</template>实现路由配置
下面的配置把仪表盘和系统管理拆成两个父级模块。子路由的 path 使用相对路径,Vue Router 会自动与父路径拼接;父路由的 redirect 使用路由名称,避免以后修改 URL 时同步维护硬编码地址。
// src/router/index.ts
import { createRouter, createWebHistory, type RouteRecordRaw } from 'vue-router'
const routes: RouteRecordRaw[] = [
{
path: '/',
component: () => import('@/layouts/AdminLayout.vue'),
redirect: { name: 'dashboard-home' },
children: [
{
path: 'dashboard',
name: 'dashboard-home',
component: () => import('@/views/dashboard/DashboardView.vue'),
meta: { title: '仪表盘' }
}
]
},
{
path: '/system',
component: () => import('@/layouts/AdminLayout.vue'),
redirect: { name: 'system-users' },
children: [
{
path: 'users',
name: 'system-users',
component: () => import('@/views/system/UserListView.vue'),
meta: { title: '用户管理' }
},
{
path: 'roles',
name: 'system-roles',
component: () => import('@/views/system/RoleListView.vue'),
meta: { title: '角色管理' }
}
]
}
]
export default createRouter({
history: createWebHistory(),
routes
})预期结果
访问 / -> 自动进入 /dashboard
访问 /system -> 自动进入 /system/users
访问 /system/roles -> AdminLayout 中的 RouterView 渲染 RoleListView实际开发服务器端口可能不同;只需在当前项目地址后追加上述路径进行验证。
验证与常见问题
先直接访问每个完整 URL,再从页面内使用 <RouterLink> 切换。刷新后仍能显示对应页面,说明前端路由与服务器回退配置都正常。若开发环境正常、生产刷新却返回 404,应让 Web 服务器把未知路径回退到 index.html。
子路由路径不要写成 /users。前导斜杠会把它变成绝对路径,最终 URL 不再继承 /system。路由名称还应保持全局唯一,否则按名称跳转时可能命中错误记录。
若地址变化但内容不变,优先检查父布局是否包含 <RouterView />;若访问 /system 没有跳转,检查 redirect 指向的路由名称是否存在;若组件加载失败,再核对文件路径与路径别名配置。