Vue / 知识点

Vue 3 开发速查手册

手册条目

使用子路由和 RouterView 构建共享布局页面。

配置嵌套路由

当多个页面需要共用侧边栏、顶部导航或面包屑时,把共享部分放进父级布局组件,再由子路由填充布局内的 RouterView。访问 /admin/users 时,外层渲染 AdminLayout,内层渲染 UsersView。

路由结构

父路由负责匹配公共路径和加载布局,子路由的 path 默认相对父路径拼接。默认子页面使用空字符串 path: "",不要写成 /;带前导斜杠的子路径会被当作根路径,失去父路径前缀。

嵌套路由渲染关系

基本配置

片段示例,依赖已安装 vue-router@4,并已有 AdminLayout.vue、DashboardView.vue 和 UsersView.vue。在 src/router/index.ts 中定义父子路由:

ts
import { createRouter, createWebHistory } from "vue-router"
import AdminLayout from "@/layouts/AdminLayout.vue"
import DashboardView from "@/views/admin/DashboardView.vue"
import UsersView from "@/views/admin/UsersView.vue"

export const router = createRouter({
  history: createWebHistory(import.meta.env.BASE_URL),
  routes: [
    {
      path: "/admin",
      component: AdminLayout,
      children: [
        // 空路径表示访问 /admin 时显示默认子页面
        { path: "", name: "admin-home", component: DashboardView },
        { path: "users", name: "admin-users", component: UsersView }
      ]
    }
  ]
})

父布局必须保留子路由出口:

vue
<script setup lang="ts">
import { RouterLink, RouterView } from "vue-router"
</script>

<template>
  <section>
    <nav>
      <RouterLink :to="{ name: 'admin-home' }">概览</RouterLink>
      <RouterLink :to="{ name: 'admin-users' }">用户</RouterLink>
    </nav>
    <RouterView />
  </section>
</template>

预期结果:打开 /admin 显示共享导航和概览页;打开 /admin/users 时共享导航不变,只有内层内容切换为用户页。浏览器控制台不应出现 No match found 或组件加载错误。

高频用法

需要多层布局时继续在子路由中声明 children,但每一级布局都必须提供自己的 RouterView。需要详情页时使用相对动态路径,例如 { path: "users/:id", component: UserDetailView },最终地址为 /admin/users/<ID>。

需要让父地址只负责跳转时,可以给父记录添加 redirect: { name: "admin-home" };若已经配置空路径默认子路由,通常不再需要重复重定向。

风险与排障

  • 子路由写成 /users 时会匹配根地址 /users,后果是布局关系与预期不一致;安全做法是删除前导斜杠。
  • 页面只显示父布局时,先检查父布局是否遗漏 <RouterView />,再检查子组件导入路径和默认导出。
  • 刷新 /admin/users 返回服务器 404,说明静态服务器没有回退到 index.html;应配置 SPA history fallback,或在无法控制服务器时改用 createWebHashHistory()。
  • 链接跳转异常时优先使用命名路由,避免手写路径时漏掉父级前缀。

兼容 Vue 3 与 Vue Router 4;Vue Router 3 的配置对象相似,但对应 Vue 2,不能与 Vue 3 项目混用。

目录与阅读设置

记录一个想法

Vue 3 开发速查手册

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

登录哪都通