Skip to main content
菜单管理用于维护平台的导航结构、页面路由与权限标识。合理的菜单设计可提升可用性，并与 RBAC 权限形成统一的访问控制闭环。

​
概述

在此页面管理 LangChat Pro 平台的菜单信息，可新增/编辑菜单： image-20250926152311059

​
配置项说明

image-20250926152341096
  • 菜单名称（必填）：展示在侧边栏/导航中的名称
  • 上级菜单：树形结构父级；为空则为顶级菜单
  • 菜单类型（必填）：目录/菜单/按钮（按钮常用于细粒度权限）
  • 是否禁用：禁用后菜单不可见或不可点击
  • 权限标识（必填）：用于 RBAC 判定的唯一权限码（如 sys:menu:list）
  • 菜单路径（必填）：对应前端路由 Path（URL）
  • 菜单图标：统一使用内置离线图标，格式 svg:xxx（由前端代码区配置）
  • 组件路径：前端 views/ 目录下对应的组件路径
  • 排序：同层级显示顺序，数字越小越靠前
菜单图标采用离线模式，请复用内置图标或在前端代码中统一注册，避免在线图标导致的加载失败与安全隐患。

​
与 RBAC 的关系

  • 权限校验：前后端基于“权限标识”进行路由/按钮级别的显示与接口鉴权
  • 角色绑定：角色分配菜单权限后，用户继承角色权限
  • 按钮权限：非页面级功能（如导出、删除）应以“按钮类型”菜单形式配置唯一权限码

​
与前端路由的关系

  • 菜单路径需与前端 router 定义一致
  • 组件路径指向 views/ 下的实际组件文件
  • 懒加载/代码分割：建议在路由层开启，提升首屏与切换性能

​
最佳实践

  • 命名规范：权限标识统一前缀与命名约定，如 sys:module:action
  • 最小授权：仅为角色分配必要菜单与按钮权限
  • 一致性：菜单与路由/组件保持一一对应，避免“死链”
  • 发布流程：新增菜单需同步前端路由与组件，测试通过后再放开权限
此功能主要面向开发与平台管理员。在新增菜单前，请先创建对应的前端组件与路由配置。