Vue / 系统课时
路由实例与页面映射
路由实例与页面映射
本节完成一个最小但完整的 Vue Router 配置:创建 history、声明页面路由、组织嵌套路由,并用默认跳转把父级入口导向具体子页面。完成后,你可以从 URL 稳定映射到页面组件,并为后续权限、懒加载和页面布局打好结构基础。
学习目标
- 能使用
createRouter与createWebHistory创建路由实例。 - 能用路由记录把路径映射到页面组件,并组织父子嵌套路由。
- 能正确配置默认跳转,并理解父级
<RouterView>在嵌套路由中的作用。
建立路由实例
Vue Router 的核心由两部分组成:history 决定 URL 如何与浏览器历史协作,routes 决定具体路径匹配哪个页面组件。企业项目通常把路由配置独立放在 src/router/index.ts,再在应用入口注册。以下为片段示例,假设项目已经安装 vue-router 且示例页面组件存在。
import { createRouter, createWebHistory } from 'vue-router'
import HomePage from '@/views/HomePage.vue'
import SettingsLayout from '@/views/settings/SettingsLayout.vue'
import ProfilePage from '@/views/settings/ProfilePage.vue'
import SecurityPage from '@/views/settings/SecurityPage.vue'
const router = createRouter({
history: createWebHistory(import.meta.env.BASE_URL),
routes: [
{
path: '/',
name: 'home',
component: HomePage
},
{
path: '/settings',
component: SettingsLayout,
children: [
{
path: '',
redirect: { name: 'settings-profile' }
},
{
path: 'profile',
name: 'settings-profile',
component: ProfilePage
},
{
path: 'security',
name: 'settings-security',
component: SecurityPage
}
]
}
]
})
export default routercreateWebHistory() 使用常见的 History API 地址形式,例如 /settings/profile。import.meta.env.BASE_URL 能让路由基地址与 Vite 的部署基路径保持一致,避免应用部署到子目录时手写前缀。
理解页面映射与嵌套关系
一个路由记录至少要解决“匹配条件”和“渲染目标”。path 负责匹配 URL,component 指向要渲染的页面。name 不是强制字段,但企业项目通常保留稳定的名称,方便跳转时避免手写路径。

父路由使用 children 后,子路由的 path 通常写相对路径,不以 / 开头。这样 profile 会自动组合成 /settings/profile,并且会渲染到父组件中的 <RouterView>。
SettingsLayout.vue 至少需要保留子路由出口。以下为片段示例:
<template>
<main>
<h1>设置中心</h1>
<RouterView />
</main>
</template>如果父路由声明了 children,但父组件没有 <RouterView>,URL 虽然可能成功匹配,子页面却没有可渲染的位置。
注册并验证路由
在应用入口把路由实例注册到 Vue 应用。以下为片段示例:
import { createApp } from 'vue'
import App from './App.vue'
import router from './router'
createApp(App)
.use(router)
.mount('#app')根组件也要提供顶层路由出口。以下为片段示例:
<template>
<RouterView />
</template>启动项目后访问对应地址:
npm run dev预期输出
VITE v<VALUE> ready in <TIME> ms
Local: http://localhost:<PORT>/实际 Vite 版本、启动耗时与端口可能不同。打开 / 应显示首页;访问 /settings/profile 应在设置布局中显示个人资料页;访问 /settings/security 应在同一布局中显示安全设置页。
用默认跳转稳定入口
/settings 本身只代表一个页面分组时,通常不希望它显示空白内容。上面的空子路径记录会在访问 /settings 时重定向到命名路由 settings-profile,最终地址变为 /settings/profile。
使用命名路由作为重定向目标有一个好处:以后如果实际路径从 profile 改成 account,只要保留名称并更新该路由记录,默认跳转逻辑不需要同步改字符串。
路由配置的关键不是把所有页面一次性写进一个数组,而是让 URL 层级、页面布局层级和业务导航层级尽量一致。这样嵌套路由才能真正承担页面组织职责,而不是只充当跳转表。