--- 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)