半年后丢失的是哪一层信息
YAML 把处理分成表示、序列化与呈现。注释、节点样式、标量格式以及映射键的书写顺序,分别在呈现或序列化阶段出现。加载时,解析丢弃呈现细节,构造只使用表示图中的序列、映射与标量。Clash 配置在半年后仍能运行,只说明表示层还在;当时为什么改若从未写入井号注释,或在转储时未被处理器保留,文本里就只剩下数据。适用条件是:文件仍能看作合法 YAML,但无法从键值单独读出改动动机。
规范还指出,即使处理器直接在原生结构与字符流之间转换,构造时也不应引用注释。因此,不能把程序还能工作当成原因已被记录。整理线索要承认:动机不是内核字段,只能从残留注释和结构痕迹去回推,并且每条假设都要能指回文件中的具体位置。
从文本回推线索的步骤
先扫文档前缀与正文中所有井号行。规范示例允许在文档开始标记之前用注释写下说明,也允许在键旁标注。这些文字不参与构造,却是半年后唯一直接记录动机的地方。把每一条注释抄到它邻近的键或序列项旁边,形成对照表。
再按集合拆分。块序列每一项独占一行并以短横线开头,块映射以冒号连接键值。流式写法里,方括号表示流序列,花括号表示流映射。相关键被写在同一缩进块里,通常是一次修改的范围,尽管表示里映射键无序、顺序只是序列化时强加的。把同一块内的键列成一组,问这组一起出现是为了什么。样式从块改为单行流,本身也是呈现痕迹,可记录为曾被压缩书写,但不能当成运行时条件。
然后看标量形态。字面样式保留换行,折叠样式把换行变成空格,带引号的流标量允许转义。若某值突然改用多行块,说明当时可能要保存多行文本;那是标量内容,不要和注释混读。锚点用与号声明、用星号引用,这是两处本是同一节点的结构化线索,比口头记忆可靠。
若文件出现文档分隔,规范用三条短横线开始文档,也可用三条点结束而不开启新文档。多个文档应分别整理,避免把上一文档的注释安到下一文档的键上。判断一条线索是否成立:必须能在文件中指到具体节点或具体注释。规范的目标包含人类可读,因此缩进层级、相邻注释、别名复用都可以作为阅读依据,但不能发明文件里不存在的操作记录。
线索不足时怎样收口
几乎没有注释时,不要补写不存在的历史。只记录当前表示:有哪些键、序列有多长、哪些节点被别名共享,把为什么标成未知。下一次改动时在合法位置用井号补上目的;这不会改变构造结果,只要不破坏缩进与纯量。若每次保存后注释消失,说明呈现阶段未保留它们,应保存带注释的源文件,避免只保留加载后再转储的输出。无法解析时,先处理规范所说的格式失败点,例如缩进、指示符、注释截断纯量,以及别名是否指向已识别的锚点,恢复合法流之后再整理线索。不要把标签、指令或键的书写顺序误认成注释。线索互相矛盾时,以仍存在的键值为准,因为只有表示会进入原生结构。