Vue / 系统课时

组织嵌套路由

组织嵌套路由

本节把管理后台的模块页组织成清晰的父子路由:父路由负责挂载后台布局,子路由负责渲染具体页面,并通过默认跳转让访问模块根路径时自动进入指定子页面。完成后,你可以独立配置两级以上的后台页面结构。

学习目标

  • 理解父级布局、子路由和 <RouterView /> 的配合关系。
  • 使用相对路径配置模块页面与默认跳转。
  • 能通过地址栏和路由匹配结果验证嵌套路由。

设计父子路由关系

嵌套路由不是单纯把配置对象放进 children。当浏览器访问 /system/users 时,Vue Router 会同时匹配 /system 和它的子路由 users:父记录先渲染后台布局,布局中的 <RouterView /> 再渲染用户列表页。

嵌套路由的匹配与渲染关系

父组件如果没有路由出口,子路由虽然能够匹配,但页面不会出现。后台布局至少要保留一个 <RouterView />,侧边栏、顶部栏等公共区域则放在出口之外。

vue
<!-- 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 时同步维护硬编码地址。

ts
// 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
})

预期结果

text
访问 /              -> 自动进入 /dashboard
访问 /system        -> 自动进入 /system/users
访问 /system/roles  -> AdminLayout 中的 RouterView 渲染 RoleListView

实际开发服务器端口可能不同;只需在当前项目地址后追加上述路径进行验证。

验证与常见问题

先直接访问每个完整 URL,再从页面内使用 <RouterLink> 切换。刷新后仍能显示对应页面,说明前端路由与服务器回退配置都正常。若开发环境正常、生产刷新却返回 404,应让 Web 服务器把未知路径回退到 index.html。

子路由路径不要写成 /users。前导斜杠会把它变成绝对路径,最终 URL 不再继承 /system。路由名称还应保持全局唯一,否则按名称跳转时可能命中错误记录。

若地址变化但内容不变,优先检查父布局是否包含 <RouterView />;若访问 /system 没有跳转,检查 redirect 指向的路由名称是否存在;若组件加载失败,再核对文件路径与路径别名配置。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

组织嵌套路由

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通