# 键来YAML源稿：两空格保住层级，引号保住标题里的井号

语言：zh-CN
原文：[键来YAML源稿：两空格保住层级，引号保住标题里的井号](<https://allluckly.cn/guides/jianlai-yaml-two-space-nested-mapping-quoted-hash/>)
中文：[中文 HTML](<https://allluckly.cn/guides/jianlai-yaml-two-space-nested-mapping-quoted-hash/>)
English: [English HTML](<https://allluckly.cn/en/guides/jianlai-yaml-two-space-nested-mapping-quoted-hash/>)
发布于: 2026-11-19T00:00:00+08:00
内容更新于: 2026-11-19T00:00:00+08:00
署名：Bison

在普通文本框手输一份四行YAML卡，逐行核层级、半角冒号和引用文字。交付原稿、去缩进反例与外部解析记录；键来负责录入，宿主负责编辑，YAML解释由另外工具完成，不把屏幕排齐当配置已经生效。

在普通文本框手输一份四行YAML卡，逐行核层级、半角冒号和引用文字。交付原稿、去缩进反例与外部解析记录；键来负责录入，宿主负责编辑，YAML解释由另外工具完成，不把屏幕排齐当配置已经生效。

## 先把纯文本工作卡与真实配置分开

新建自己的练习草稿，确认当前为键来，记录宿主与真实输入状态。目标只描述一节虚构课程，不含账号、密钥或实际服务地址，不粘进任何生产设置。根键lesson下有title、note、copies三项，标题原文Harbor #2，备注是文字on，份数为数字3。先在外部保留这份结构要求，再开始录入，不能一边改错稿一边把要求改成与它相符。宿主需要能保留实际换行和普通空格；若只有富文本排版而看不清源字符，先换自己已有的普通草稿工具，不能声称键来提供YAML专用编辑器。

## 按四行原样录入并核两格缩进

先输入lesson与半角冒号，再真实换行。后三行各先输入两个普通空格，再写键、冒号、一空格与值；每完成一行就核正文，不把候选预览当已经提交。下方是完整目标，最后copies行保留在子层级，不加项目符号或额外空白行。本课选两空格是明确书写契约，不是说YAML只能使用两格；关键是当前同层保持一致。不要用全角空格、Tab或屏幕自动缩进的外观替代字符检查，宿主若自动补空格，应记真实插入方式，不能把自动补齐算成自己逐个手输。

```
lesson:
  title: "Harbor #2"
  note: "on"
  copies: 3
```

## 把缩进字符与键盘Tab动作分开

YAML块式结构依据缩进，规范为可移植性要求缩进不用制表符。宿主按Tab时可能插入若干空格、插入一枚Tab，也可能把焦点移到别的控件，三种结果不能混写。逐行确认前三个子键前恰为本课两枚U+0020空格；没有显示不可见字符的能力时，把自己的副本交给现有文本工具核查，并保留限制。这里不主张YAML任何位置都禁止Tab，行内分隔与缩进另有规则；也不因为上一课TSV需要真正Tab，就将同一种分隔字符照搬到本课行首。目标不同，字符契约也不同。

## 引号内的井号与引号外注释各守范围

标题的ASCII双引号包住Harbor #2，井号与前面的空格属于标题文字，不是要删除的说明。另做外部反例，只去掉标题两端引号，成为title: Harbor #2；此处空格后的井号会开启注释，值变为Harbor，不再是目标标题。把反例与原稿分别保存，不在真实稿上反复删引号后凭记忆修复。备注on也明确带引号以保持字符串；不同YAML版本或解析模式对未引用文字可能有不同类型处理，本课不去掉引号后替所有工具预言同一个布尔结果。

## 外部解释后核嵌套位置与值类型

有自己已有的可信YAML工具时，只在离线练习副本解析，记录工具版本和采用的规范或模式。预期根只有lesson，子对象有三个键，title完整为Harbor #2、note为字符串on、copies为数值3；既核值也核位置，不只看没有报错。本文没有执行任何真实服务配置加载，解析也不会让课程自动建立。未使用解析器时可交逐字符和结构手工账，机器解释一栏标未执行，不把网站构建通过当手机输入的文件已经由全部YAML1.2工具验收；具体实现和模式仍需自己的真实结果。另在纸面加入第二个title键作结构检查，当前lesson映射不应把两个同名子键当成两份独立标题。某工具未报错也不等于重复键符合本课目标，应按规范与工具模式分别记录，不以最后显示值替换原始重复证据。

## 只去最后一行缩进建立结构反例

从合格副本另存一份，只删最后copies行前的两空格，其他行保持。现在copies成为根键，lesson只剩title与note；即使外部解析仍成功，也不符合原三子项结构。这个反例特意把copies放最后，避免后面还有子行让一次去缩进同时产生另一种语法错误。分别保存原样比较、解析是否成功、所得对象结构三栏，不因数字仍为3就勾结构正确。修订实际稿时只恢复那两格，再核四条源行和引号，不同时改键名、类型或数值，以便问题能追溯。

```
lesson:
  title: "Harbor #2"
  note: "on"
copies: 3
```

## 按行首字符冒号和引用边界排错

出现错误先核行首是否混Tab、冒号是否全角、双引号是否成对，再看宿主是否把文本改成智能引号。解析成功但数据不对时，回嵌套对象和完整标题，不先重装输入法。屏幕折行不增加源行，不能为了视觉四行删掉正确空格。若文本工具在保存时自动重排键或规范缩进，保留保存前后两份，区分语义等价与原样一致；本课要求的原样目标不能被自动美化后的截图替代。每次修一项并记实际反馈，不虚构键来有语法提示、自动修复或配置部署功能。

## 重开交付原样结构与解释三层记录

重开自己的草稿后，重新核四行、三组两空格、完整引号与copies仍在lesson里面；未实际重开就不填保存保持。交付原稿、无引号控制、去缩进控制和实际解析记录，说明哪些是键来输入、哪些由宿主编辑、哪些在外部解释。恢复日常方案与文本设置，不把练习导入正式应用。验收既问逐字是否一致，也问数据结构是否符合，不能把两者合并成一个绿色标记。以后增加列表、更多嵌套或其他标量形式，应按新规范重新核，不从这四行推全部YAML语法或所有宿主兼容性。

## 相关教程与资料

[真正制表符与分列](<https://allluckly.cn/guides/jianlai-tsv-real-tabs-three-column-handoff/>)、[JSON字符串与数字](<https://allluckly.cn/guides/jianlai-json-object-string-number-source-contract/>)。

资料核对：2026 年 11 月 19 日，[Apple 芬兰区公开查询](<https://itunes.apple.com/lookup?id=6754281557&country=fi&entity=software&timestamp=20261119>)与[中国区查询](<https://itunes.apple.com/lookup?id=6754281557&country=cn&entity=software&timestamp=20261119>)均列键来 1.0.5，最低 iOS / iPadOS 16.0；[官方商店](<https://apps.apple.com/fi/app/id6754281557>)说明主题、背景、字体及多语言输入等能力。本文按安装版真实入口操作；系统编辑与宿主处理另作区分。以下为可重做步骤及纸面预期，没有声称已完成真机输入、宿主兼容或格式解析测试。

方法资料：[YAML1.2.2缩进与引用规范](<https://yaml.org/spec/1.2.2/>)。

