字典管理
后台管理 > 字典管理 这一页，主要用于维护系统里的通用字典项。
你可以把它理解成“平台统一口径配置表”：
- 某个业务标识应该怎么写
- 某个下拉选项应该显示什么文本
- 某些模型厂商、模型分类、状态枚举该怎么统一维护
如果前面页面里出现很多固定选项、固定映射、固定标识，通常都和这里的字典配置有关。
先看列表页
进入字典管理后，首先看到的是字典列表。
这页建议重点看下面几列：
字典名称直接说明这本字典在管什么内容。业务标识相当于这本字典对外使用的业务 key，后续很多地方会按它来取值。描述 / 备注用来补充这本字典的用途、来源或维护说明。启用决定这本字典当前是否参与系统使用。更新时间帮你判断这本字典最近有没有被维护过。
如果你只是要查某本字典，通常按这个顺序看就够了：
- 先按
字典名称 / 业务标识搜索 - 再确认
启用状态 - 最后进入
详情或编辑
什么时候需要新增字典
当系统里出现一类新的统一选项，或者某个功能需要单独维护一套固定映射时，就会新增字典。
比如这类场景就很常见：
- 新增一组模型厂商映射
- 新增某个业务模块的状态枚举
- 新增页面下拉选项所依赖的统一数据
点击右上角 新增字典 后，会进入新增弹窗。
新增字典怎么填
新增时可以分成两部分去理解：
1. 字典基本信息
上半部分主要填写：
字典名称业务标识启用描述备注
这里最重要的是前两项：
字典名称给人看的，建议直接写业务名称，不要太抽象。业务标识给系统识别用，后续很多地方会按这个标识去取这本字典。
实操建议：
- 名称尽量写得一眼能懂
- 业务标识保持统一风格，不要今天下划线、明天横杠混着来
- 描述写清楚“这本字典是给谁用的、解决什么问题”
2. 字典内容
下半部分是这本字典真正的内容。
每一行通常就是一个字典项，常见字段有：
Label页面上展示给用户看的文本Value实际存储或传递的值备注对单个字典项的补充说明排序决定显示顺序启用决定这条字典项是否可用
一般来说，最少要先把 Label 和 Value 填完整。
这块可以按下面思路去维护：
Label写用户看得懂的名字Value保持稳定，不要频繁改动排序决定展示先后- 临时不用的项可以先关掉，不一定马上删除
详情页怎么看
点击列表里的 详情，会打开当前字典的只读信息页。
这一页最适合做三件事：
- 看这本字典到底是干什么的
- 看这本字典当前收了哪些字典项
- 核对每个
Label / Value是否符合当前业务口径
如果你是培训、实施或者排查问题，详情页通常比编辑页更适合讲解，因为：
- 信息完整
- 不容易误操作
- 能直接看到整本字典当前的启用内容
建议在详情页重点核对：
- 名称和业务标识是否对得上
- 描述有没有写清楚用途
- 字典项数量是否完整
- 某些关键项有没有被误关掉
编辑页主要改什么
点击 编辑 后，会进入可修改状态。
编辑通常分两类：
1. 修改字典本身
比如：
- 改字典名称
- 补充描述
- 调整启用状态
- 完善备注
这类修改影响的是整本字典的说明和状态。
2. 修改字典项
比如：
- 新增一行字典项
- 调整
Label / Value - 调整排序
- 关闭某一条字典项
- 删除不再使用的项
这类修改影响的是这本字典里具体有哪些可选值。
修改时要特别注意什么
字典看起来只是配置，但很多页面、下拉框、映射逻辑都会依赖它。
所以编辑时建议注意这几件事：
- 不要随意改已经被大量使用的
Value因为很多地方可能就是按这个值在识别。 Label可以优化文案，但也要注意和业务口径保持一致- 删除前先确认是不是还有页面在用
- 不确定时，优先关停而不是直接删掉
如果你只是想临时下线某一项，最稳的做法通常是： 先把这一项或整本字典 启用 关掉，而不是直接删数据。
怎么判断字典配得对不对
可以用最简单的四步来判断：
- 名称和业务标识是否清楚
- 字典项的
Label / Value是否一一对应 - 排序和启用状态是否符合当前页面展示预期
- 依赖这本字典的页面是否能正常展示和使用
如果满足这四点，通常就说明这本字典已经可用了。
给别人讲这页时怎么讲
如果你要给业务、实施或培训同学讲字典管理，建议就按这个顺序：
- 先讲“字典是什么”
- 再讲列表页怎么查
- 再讲新增时基本信息和字典内容分别填什么
- 最后讲编辑时哪些值不要乱改
这样别人会更容易理解： 字典管理不是单纯填表，而是在维护系统统一口径。