路径：支持库 → 基础支持库 → 键值对 / 字典。
遍历字典用 遍历(项, 字典) / 遍历(键, 值, 字典)，见 basic-flow.md；数组声明见 language.md §4.1。
硬约束
- 扁平命令；键值对容器（非类）。键必须为文本。
- 也可用
通用 x = {}创建；命令形如字典_置/创建字典。 - 键不存在时取值行为以各命令说明为准。
快速开始
通用 配置 = 创建字典()
字典_置(配置, "a", 1)
输出(字典_取(配置, "a"))
输出(字典_含键(配置, "a"))
键值对
本分类共 10 条。
创建字典
- 签名：
通用 创建字典() - 说明：创建一个空的键值对字典（通用/TypeDict）。也可用 通用 x = {}。键必须为文本；值可为整数、小数、逻辑、文本等。
字典_删
- 签名：
通用 字典_删(通用 字典, 文本 键) - 说明：删除指定键并返回更新后的字典。键不存在时不做改动，仍返回原字典。
- 参数一│字典: 目标字典（通用/TypeDict）。非字典时原样返回。
- 参数二│键: 要删除的文本键名。不存在则忽略。
字典_取
- 签名：
通用 字典_取(通用 字典, 文本 键) - 说明：按键读取值。键不存在、字典无效或为空时返回空通用（可用 字典_含键 先判断）。也可用下标写法 字典[“键”]。
- 参数一│字典: 要读取的字典（通用/TypeDict）。非字典时返回空通用。
- 参数二│键: 文本键名，须与写入时一致（区分大小写）。
字典_取长整数
- 签名：
长整数 字典_取长整数(通用 字典, 文本 键) - 说明：按键读取整数值（内部存为长整数）。键不存在或值非整数时返回 0。
- 参数一│字典: 要读取的字典（通用/TypeDict）。
- 参数二│键: 文本键名。
字典_含键
- 签名：
逻辑 字典_含键(通用 字典, 文本 键) - 说明：判断字典是否包含指定键。
- 参数一│字典: 要检查的字典（通用/TypeDict）。非字典时返回 假。
- 参数二│键: 文本键名。存在返回 真，否则 假。
字典_批量置
- 签名：
通用 字典_批量置(数组 数据, [整数 维度=1]) - 说明：由数组一次性创建字典（只刷新一次内部表示，适合大量写入）。支持两种布局：① 一维交错 [键,值,键,值,…]（默认维度 1）；② 二维每行一对 [键,值]（维度 2）。注意 Y++ 数组用 []，{} 表示字节集。返回新建字典，不会修改传入的旧变量，请用返回值赋值。
- 参数一│数据: 一维数组（交错键值）或二维数组（每行至少两个元素：键、值）。键会转成文本。
- 参数二│维度: 可选，默认 1。1=按一维交错解析；2=按二维行解析。
字典_数量
- 签名：
整数 字典_数量(通用 字典) - 说明：返回字典中键值对的个数。
- 参数一│字典: 要统计的字典（通用/TypeDict）。非字典或为空时返回 0。
字典_清空
- 签名：
通用 字典_清空([通用 字典]) - 说明：返回一个新的空字典。请将返回值赋回变量以清空原引用。
- 参数一│字典: 可选。传入旧字典仅作兼容占位，实际总是返回新建的空字典；省略参数效果相同。
字典_置
- 签名：
通用 字典_置(通用 字典, 文本 键, 通用 值) - 说明：设置键值并返回更新后的字典（请重新赋值给变量）。键已存在则覆盖。单次写入会刷新内部表示；大量写入请用 字典_批量置。
- 参数一│字典: 目标字典（通用/TypeDict）。非字典时行为未定义，请先 创建字典。
- 参数二│键: 文本键名。
- 参数三│值: 要写入的值（整数/小数/逻辑/文本等）。
字典_键列表
- 签名：
数组 字典_键列表(通用 字典) - 说明：返回字典全部键名组成的一维数组（元素为文本）。字典为空或无效时返回空数组。
- 参数一│字典: 要枚举键名的字典（通用/TypeDict）。非字典时返回空数组。
易错对照
| 错误 | 正确 |
|---|---|
| 当数组用数字下标 | 字典用文本键 |
| 未创建就置值 | 先 创建字典() 或 {} |