菜单与资源管理
菜单与资源管理模块定义系统的导航结构和按钮级权限。所有前端页面路由和操作按钮的访问控制均在此配置。
功能入口
登录后点 平台管理 → 菜单管理（/system/menu）。
2026-08-26 演示站实拍。可按全部 / PC端 / 报表系统 / APP端 / 移动端筛选。左侧是资源结构，中间是列表（名称、类型、路由、权限），右侧是选中项详情。主按钮：新增顶级菜单。
菜单类型
sys_resource.resource_type 是四种：
| 值 | 类型 | 说明 |
|---|---|---|
1 | 目录 | 一级分类，不绑页面 |
2 | 菜单 | 绑页面路由 |
3 | 按钮 | 页内操作 |
4 | API 接口 | 后端 URI，演示新增资源里有这一项 |
新增菜单
主按钮是 新增顶级菜单。弹窗标题是「新增资源」。
2026-08-26 演示站实拍。三块：基础信息、目录/菜单配置、状态配置。按钮是 取消 / 保存。
| 分组 | 字段 | 必填 | 说明 |
|---|---|---|---|
| 基础信息 | 上级资源 | 否 | 顶级资源 |
| 基础信息 | 资源名称 | 是 | |
| 基础信息 | 资源类型 | 是 | 目录 / 菜单 / 按钮 / API接口 |
| 基础信息 | 客户端 | 是 | PC端 / 报表系统 / APP端 / 移动端 |
| 基础信息 | 最低用户类型 | 是 | 如普通用户 |
| 基础信息 | 排序 | 否 | |
| 目录/菜单配置 | 图标 | 否 | 字体图标或图片图标 |
| 目录/菜单配置 | 路由地址 | 否 | 可搜索已有页面路由 |
| 目录/菜单配置 | 组件路径 | 否 | 可搜索已有组件 |
| 目录/菜单配置 | 重定向地址 | 否 | |
| 目录/菜单配置 | 是否外链 / 启用SSO / 是否缓存 / 总是显示 | 否 | |
| 状态配置 | 显示状态 | 否 | 显示 / 隐藏 |
| 状态配置 | 菜单状态 | 否 | 显示 / 隐藏 |
| 状态配置 | 备注 | 否 |
列表中间可按名称 / 路由 / 权限 / API 搜，支持批量迁移、批量删除。左边是资源结构树。
路由配置
路由地址是菜单与前端页面的桥梁，配置要点：
- 路由地址以
/开头，如/system/user - 父子菜单的路由地址应保持层级关系
- 组件路径对应
forge-admin-ui/src/views/下的.vue文件
权限标识
权限标识用于后端接口鉴权，与 @SaCheckPermission 注解配合使用：
- 菜单权限：
system:user:list（查看用户列表） - 按钮权限：
system:user:add、system:user:edit、system:user:remove - 遵循
模块:功能:操作的命名规范
图标选择
点击图标字段旁的图标选择器，可浏览并选取合适的图标。Forge Admin 内置丰富的图标库，支持按关键词搜索。
编辑与删除
- 在菜单树中点击目标节点，右侧面板显示其信息后，可修改并保存
- 删除菜单节点前，系统会检查是否存在子级菜单，如有则需先删除子级
- 删除菜单不会自动删除关联的角色权限，需在角色管理中手动清理
相关文档
- 角色管理 — 了解如何为角色分配菜单
- RBAC 权限配置指南 — 完整的权限配置流程