字典管理

字典管理模块用于维护系统中的枚举常量数据，通过键值对的形式统一管理下拉选项和状态标签，避免前端硬编码。

功能入口

登录管理后台后，点击左侧菜单 系统管理 > 字典管理，进入字典管理页面。页面左侧展示字典类型列表，右侧展示选中类型下的字典数据。

字典类型与字典数据

字典体系分为两个层级：

• 字典类型：字典的分类定义，如 sys_user_sex（用户性别）
• 字典数据：字典类型下的具体键值对，如 0 = 男, 1 = 女

新增字典类型

1. 在字典管理页左侧，点击 新增 按钮
2. 弹出新增字典类型表单，填写：
   • 字典名称（必填）：如"用户性别"
   • 字典类型（必填）：唯一编码，使用小写下划线命名，系统级建议 sys_ 前缀，如 sys_user_sex
   • 状态：正常 / 停用
3. 点击 确定 完成创建

添加字典数据

1. 在左侧字典类型列表中，点击目标字典类型
2. 右侧面板显示该类型下的字典数据列表，点击 新增 按钮
3. 填写字典数据项：
   • 字典标签：前端显示的文本，如"男"
   • 字典键值：后端存储的值，如 0
   • 样式回显：可选，控制 DictTag 标签颜色
   • 排序号：控制下拉选项的显示顺序
   • 状态：正常 / 停用
4. 点击 确定 保存
5. 重复以上步骤添加所有需要的数据项

前端组件使用

Forge Admin 提供了两个专用组件来消费字典数据：

DictSelect 下拉选择

DictSelect 组件用于表单中的下拉选择，自动从字典加载选项：

<DictSelect dict-type="sys_user_sex" v-model:value="formData.sex" />

• dict-type 属性指定字典类型编码
• 组件自动请求后端字典接口获取选项列表
• 支持 v-model:value 双向绑定

DictTag 标签渲染

DictTag 组件用于表格中渲染字典标签，自动匹配颜色样式：

<DictTag :value="row.status" dict-type="sys_normal_disable" />

• value 属性传入字典键值
• dict-type 属性指定字典类型
• 自动根据字典数据的样式配置渲染对应颜色标签

字典使用规范

• 下拉选项和状态标签必须使用字典组件，禁止前端硬编码
• 字典数据通过 useDict('<dict_type>') 组合式 API 读取
• 字典值的 dict_value 必须与后端枚举/存储值保持一致
• 业务枚举和可配置枚举必须维护到字典表，禁止写死 options

相关文档

• 动态配置管理 — 了解参数配置与字典的区别