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 routername 应在整个路由表中唯一,适合在代码中进行稳定跳转;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。
按自己的节奏,确认真正理解。