2.3 KiB
2.3 KiB
name, description, disable-model-invocation
| name | description | disable-model-invocation |
|---|---|---|
| vue2-route-permission | Use when adding or modifying route/menu/permission access in this Vue2 admin project, including module router files, permissionRouter aggregation, sidebar visibility, and route metadata consistency. | true |
Vue2 Route Permission
适用场景
- 新增一个业务页面,需要接入菜单与路由
- 新增一个模块路由文件并接入
permissionRouter - 调整页面可见性、菜单结构、入口名称
- 排查“路由已写但菜单不显示 / 可见但不可访问”问题
本项目路由结构认知
- 模块路由拆分在
src/router/*.js(例如signin.js) - 聚合路由在
src/router/permissionRouter.js - 侧边栏使用
store.state.routerList渲染(见src/views/main/components/nav.vue)
接入原则
- 单模块独立:每个业务域维护自己的路由文件
- 统一聚合出口:模块路由必须在
permissionRouter.js引入并加入数组 - 元信息一致:
title、meta.title、name、path保持语义一致 - 层级清晰:一级菜单挂在
Main下,子页面在children
新页面接入流程
- 在
src/views创建页面组件并命名清晰 - 在对应模块路由文件新增子路由(或新建模块路由文件)
- 设置基础字段:
path、name、title、meta.title - 需要缓存时补
meta.keepAlive - 在
permissionRouter.js引入并追加模块路由 - 验证菜单显示、点击跳转、激活状态、刷新后可访问
字段约定
path:使用短横线风格,避免含糊缩写name:驼峰命名,保持唯一title:用于菜单与页面文案,避免同义不同字icon:仅一级菜单使用,沿用 Element 图标meta.title:与title保持一致,方便统一读取
常见问题处理
- 菜单不显示:检查模块路由是否已加入
permissionRouter聚合数组 - 菜单显示但跳转异常:检查
path与组件导入是否正确 - 激活态不正确:检查路由跳转后
activeRouter是否对应当前path - 刷新丢失访问:检查路由注册时机和权限数据初始化顺序
快速参考
- 接入示例:见 examples.md
- 自检清单:见 checklist.md