Vue / 系统课时

配置基础路由

配置基础路由

本课会为管理后台创建 Vue Router 实例,并配置一个带布局的嵌套路由表。完成后,访问 / 与 /users 会分别渲染控制台和用户列表页面,同时保留统一的后台外壳。

学习目标

  • 创建基于 HTML5 History 的路由实例
  • 正确配置路径、名称、组件和 meta 元信息
  • 使用嵌套路由让业务页面渲染到布局组件内部

理解路由匹配链路

管理后台通常不是把每个页面都写成完整外壳,而是先匹配父路由的布局组件,再把子路由组件渲染到布局中的 <RouterView />。因此,父路由负责公共结构,子路由只负责业务内容。

基础路由与嵌套页面渲染链路

创建路由表

下面的路由表使用懒加载页面组件。父路由路径为 /,默认子路由使用空路径,用户列表使用相对路径 users,最终地址会自动组合为 /users。

ts
// src/router/index.ts
import { createRouter, createWebHistory } from 'vue-router'
import AdminLayout from '../layouts/AdminLayout.vue'

const router = createRouter({
  history: createWebHistory(import.meta.env.BASE_URL),
  routes: [
    {
      // 父路由只负责公共后台外壳
      path: '/',
      component: AdminLayout,
      children: [
        {
          // 空路径表示访问 / 时渲染默认子页面
          path: '',
          name: 'dashboard',
          component: () => import('../views/DashboardPage.vue'),
          meta: {
            title: '控制台',
            requiresAuth: true
          }
        },
        {
          path: 'users',
          name: 'users',
          component: () => import('../views/UserListPage.vue'),
          meta: {
            title: '用户管理',
            requiresAuth: true
          }
        }
      ]
    }
  ]
})

export default router

name 应在整个路由表中唯一,适合在代码中进行稳定跳转;path 决定浏览器地址;component 决定匹配后渲染什么;meta 用于保存标题、权限标记等业务信息,但不会自动执行鉴权。

接入布局与页面

布局组件需要同时提供导航入口和子路由出口。页面组件保持轻量,只负责各自业务内容。

vue
<!-- src/layouts/AdminLayout.vue -->
<script setup lang="ts">
import { useRoute } from 'vue-router'

const route = useRoute()
</script>

<template>
  <div class="layout">
    <aside>
      <RouterLink :to="{ name: 'dashboard' }">控制台</RouterLink>
      <RouterLink :to="{ name: 'users' }">用户管理</RouterLink>
    </aside>

    <section>
      <header>{{ String(route.meta.title ?? '管理后台') }}</header>
      <main>
        <RouterView />
      </main>
    </section>
  </div>
</template>

<style scoped>
:global(body) {
  margin: 0;
}

.layout {
  display: grid;
  grid-template-columns: 200px 1fr;
  min-height: 100vh;
}

aside {
  display: grid;
  align-content: start;
  gap: 12px;
  padding: 20px;
  background: #1f2937;
}

aside a {
  color: #dbeafe;
  text-decoration: none;
}

aside a.router-link-active {
  color: #fff;
  font-weight: 700;
}

section {
  background: #f3f4f6;
}

header,
main {
  padding: 20px;
}

header {
  background: #fff;
}
</style>

<!-- src/views/DashboardPage.vue -->
<template>
  <h1>控制台页面</h1>
</template>

<!-- src/views/UserListPage.vue -->
<template>
  <h1>用户列表页面</h1>
</template>

最后在应用入口注册路由,并让根组件只保留顶层路由出口。

ts
// src/main.ts
import { createApp } from 'vue'
import App from './App.vue'
import router from './router'

createApp(App).use(router).mount('#app')
vue
<!-- src/App.vue -->
<template>
  <RouterView />
</template>

运行与验证

启动项目后直接访问两个地址,也可以点击侧边栏链接切换。刷新 /users 仍能正常显示,说明开发服务器已正确回退到 index.html;生产部署时也需要配置同等的 History 回退规则。

bash
npm run dev -- --host 127.0.0.1

预期结果

text
访问 http://127.0.0.1:<PORT>/      显示“控制台页面”
访问 http://127.0.0.1:<PORT>/users 显示“用户列表页面”
侧边栏保持不变,顶部标题随路由切换

<PORT> 以终端实际输出为准。还应确认浏览器地址发生变化、当前导航项获得 router-link-active 类,并且控制台没有组件导入失败或重复路由名称错误。

关键边界

子路由路径不要写成 /users,否则它会成为绝对路径,降低层级关系的可读性。meta.requiresAuth 只是数据标记,真正的权限拦截应在全局导航守卫中实现。使用 createWebHistory 时,生产服务器必须把未知前端路径回退到入口文件,否则刷新深层路由会返回 404。

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

目录与阅读设置

阅读设置

17

记录一个想法

配置基础路由

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

登录哪都通