Initial commit
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,56 @@
|
||||
---
|
||||
name: vue2-route-permission
|
||||
description: 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.
|
||||
disable-model-invocation: 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`
|
||||
|
||||
## 新页面接入流程
|
||||
|
||||
1. 在 `src/views` 创建页面组件并命名清晰
|
||||
2. 在对应模块路由文件新增子路由(或新建模块路由文件)
|
||||
3. 设置基础字段:`path`、`name`、`title`、`meta.title`
|
||||
4. 需要缓存时补 `meta.keepAlive`
|
||||
5. 在 `permissionRouter.js` 引入并追加模块路由
|
||||
6. 验证菜单显示、点击跳转、激活状态、刷新后可访问
|
||||
|
||||
## 字段约定
|
||||
|
||||
- `path`:使用短横线风格,避免含糊缩写
|
||||
- `name`:驼峰命名,保持唯一
|
||||
- `title`:用于菜单与页面文案,避免同义不同字
|
||||
- `icon`:仅一级菜单使用,沿用 Element 图标
|
||||
- `meta.title`:与 `title` 保持一致,方便统一读取
|
||||
|
||||
## 常见问题处理
|
||||
|
||||
- **菜单不显示**:检查模块路由是否已加入 `permissionRouter` 聚合数组
|
||||
- **菜单显示但跳转异常**:检查 `path` 与组件导入是否正确
|
||||
- **激活态不正确**:检查路由跳转后 `activeRouter` 是否对应当前 `path`
|
||||
- **刷新丢失访问**:检查路由注册时机和权限数据初始化顺序
|
||||
|
||||
## 快速参考
|
||||
|
||||
- 接入示例:见 [examples.md](examples.md)
|
||||
- 自检清单:见 [checklist.md](checklist.md)
|
||||
Reference in New Issue
Block a user