清晰的嵌套路由模块化写法是将布局、功能域、页面三层逻辑分离:按功能域拆分路由文件,用布局组件统一包裹子路由,显式声明默认子路由与规范命名,主入口仅聚合排序路由。

嵌套路由配置容易写成一长串对象数组,越改越难读。真正清晰的模块化写法,核心是把“布局”“功能域”“页面”三层逻辑拆开,让每个文件只负责一件事。
按功能域拆分路由文件
不要把所有路由塞进一个 router/index.js。按业务划分独立文件,比如:
- src/router/modules/admin.js:后台管理相关路由(含侧边栏布局)
- src/router/modules/user.js:用户中心相关路由(含个人资料卡布局)
- src/router/modules/public.js:前台公共页(如首页、关于我们)
每个模块导出的是标准的 RouteRecordRaw[] 数组,不带 createRouter 或 history,保持纯粹。
用布局组件统一收口嵌套结构
每个功能域的子路由,必须挂在一个明确的布局组件下。例如 admin 模块里:
- 父路由
path: '/admin'对应 AdminLayout.vue,里面包含侧边栏 + 顶栏 + - 子路由如
{ path: 'users', component: UserList },路径实际为/admin/users,自动渲染在 AdminLayout 的中 - 避免出现没有 layout 包裹的“裸”页面路由——所有页面都应归属某个布局上下文
默认子路由与命名规范显式表达意图
访问 /admin 时该显示什么?靠空路径 path: '' 明确声明:
- 写成
{ path: '', redirect: { name: 'admin-dashboard' } },比redirect: '/admin/dashboard'更安全(避免硬编码路径) - 所有路由配
name,尤其嵌套场景:name: 'admin-users-list'、name: 'admin-users-detail',跳转时用router.push({ name: 'admin-users-detail', params: { id: 123 } }) - 子路由的
name用中划线连接层级,一眼看出归属关系
主路由入口做聚合与排序
src/router/index.js 只干三件事:
- 导入各模块路由数组
- 按优先级顺序拼成最终
routes(比如 public 放最后,避免/login被/:any拦截) - 传给
createRouter,不掺杂业务逻辑
示例结构:
import { createRouter, createWebHistory } from 'vue-router'
import publicRoutes from './modules/public'
import adminRoutes from './modules/admin'
import userRoutes from './modules/user'
const routes = [
...publicRoutes,
...adminRoutes,
...userRoutes
]
export default createRouter({
history: createWebHistory(),
routes
})
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!










