字典管理
校对日期:2026-11-16。适用于社区版及全部商业版。
字典是一组“名称 + 键值”的选项。自定义字段里的单选、多选、下拉字段不自己保存选项,而是绑定一个字典类型: 比如给“产品(手机)”模型加一个“机身存储”字段,64GB、128GB、256GB 这些选项就维护在字典里。 字典类型和它的条目都在同一个界面管理。
导入了演示数据的站点自带一批字典(“产品_手机_机身存储”等),并已绑定在产品、下载等文章模型的字段上,可以对照着看。
一、界面
进入 配置 → 字典管理。

- 左侧 是字典类型,按共享范围分成 全局共享、本站私有 两组。每行右边的数字是条目数,带锁的是系统字典。 上方可以按名称搜索;拖动行首的图标调整同组内的顺序。
- 右侧上方 是所选类型的信息:名称、共享范围、别名(旁边的图标用于复制)、数据类型,以及“被几个模型字段使用” (鼠标悬停可见是哪些模型的哪些字段)。编辑类型、删除类型 也在这里。
- 右侧下方 是这个类型的条目。
二、新增字典类型
点左侧搜索框旁的“+”(新增类型),填写:
| 字段 | 说明 |
|---|---|
| 名称 | 类型的显示名称,绑定字段时在下拉列表里看到的就是它 |
| 别名 | 模板和接口按别名读取这个字典(见“在模板和接口里读取”一节)。本站私有的类型之间、全局共享的类型之间各自不能重复 |
| 备注 | 选填 |
| 数据类型 | 键值是 字符串 还是 整型。没有特殊需要选字符串。新增后不能修改 |
| 共享范围 | 本站私有:只有本站能用;全局共享:所有站点都能用 |
新增、修改全局共享的字典类型及其条目需要“全局数据权限”。没有这项权限的账号看到的全局字典带 只读 标记,只能查看。
三、维护条目
选中一个类型,点 新增,填写:
- 名称:选项显示的文字。
- 键值:选项的值,同一类型内不能重复。已有的键值都是整数时,新增会自动填上下一个数。
- 备注:选填。
- 是否启用:关闭后,这个条目不再出现在前台模板和公开接口取到的字典列表里。列表里的开关可以直接拨动。
拖动行首的图标调整条目的顺序,这也是选项在编辑页和前台的显示顺序。右上角的输入框按名称或键值过滤;过滤时不能拖动排序。
四、绑定到自定义字段
- 进入 配置 → 模型管理,在要加字段的模型上点 自定义字段。
- 从左侧“选项与开关”里加入 单选框组、多选框组、下拉单选 或 下拉多选。
- 选中这个字段,在右侧 字段属性 的 字典类型 里选择字典类型,保存。

之后在文章(或栏目、表单等)的编辑页,这个字段的选项就是字典里的条目。规则:
- 全局共享的模型只能绑定全局共享的字典类型,否则其它站点看不到选项。
- 内容里同时保存选中条目的名称和键值:名称在字段代码下(如
storage),键值在“字段代码 + Key”下(如storageKey)。 之后在字典里修改条目名称,已经保存的内容里仍是原来的名称。 - 模型管理的其它用法见模型管理。
五、在模板和接口里读取
模板里用 DictList 指令按别名取一个字典的条目,常用来生成筛选条件:
html
[@DictList type='product_phone_storage'; dictList]
[#list dictList as dict]
<a href="?storageKey=${dict.value}">${dict.name}</a>
[/#list]
[/@DictList]type是字典类型的别名;也可以用typeId按 ID 取。能取到的是本站私有和全局共享的字典。- 默认只返回启用的条目,顺序与字典管理里一致。
- 对应的公开接口是
GET /,只返回启用的条目。api/ dict?type=别名 - 按字典字段筛选文章列表的完整写法,可参考默认主题的
templates/: 它列出文章模型里所有绑定了字典的字段,并把选中的键值作为查询条件传给文章列表指令。channel_ product. html
六、删除与系统字典
- 删除类型 会同时删除它的全部条目,确认框里写明条目数。仍被模型字段使用的类型不能删除,按钮置灰; 先到模型管理里给那些字段换一个字典类型。
- 把全局共享改回本站私有时,如果其它站点的模型或全局模型还在使用它,系统会拒绝。
- 系统字典 是系统自带、功能里直接按别名使用的类型,带 系统字典 标记:别名和共享范围不能改,类型不能删除。 其中标有 系统 的条目,键值和启用状态不能改,也不能删除;其余条目可以自由增删改。
| 系统字典 | 别名 | 用在哪里 |
|---|---|---|
| 文章来源 | sys_ | 文章编辑页 来源 的候选项 |
| 流程类型 | sys_ | 审核流程的类别(文章审核、表单审核) |
| 站点语言 | sys_site_lang | 站点的语言下拉,见多语言站点 |
七、常见问题
字段的选项是空的。 字段绑定的字典类型里还没有条目;全局共享的模型请绑定全局共享的字典类型。
删除类型的按钮是灰的。 该类型是系统字典、正被模型字段使用,或者它是全局字典而当前账号没有全局数据权限。 鼠标悬停在类型信息里的“被 N 个模型字段使用”上,可以看到是哪些字段。
保存类型时提示“别名已存在”。 同一共享范围里已经有这个别名,换一个。