杂记 › 技术笔记 › YAML 锚点别名是副本:引用 10 次展开成 697 字符,合并键同名时 own 压过 merged

YAML 锚点别名是副本:引用 10 次展开成 697 字符,合并键同名时 own 压过 merged

这页YAML解析器的锚点别名要挨两刀克隆才拿到副本,引用1、3、10次展开成130、256、697字符;合并键merged先铺own后写;块标量六档尾换行与跨文档锚点第4行报错逐条入账。

锚点入表要挨两刀:别名拿到的是副本

/yaml-json 这页自带一台手写 YAML 解析器:模板 76073 字节、1857 行,脚本内文 63822 字符在模板里逐字命中 1 次,100 处函数声明收敛到 99 个唯一名,外加 25 个 DOM id,解析器零外部依赖。本篇量的是它的结构层——锚点与别名的复制账、合并键的先后、块标量的行尾字节、文档边界的作用域。

值入别名表时先克隆一次,取用 *base 时再克隆一次。于是 b===a 为 false,b.sub===a.sub 也为 false:深两层都是独立对象。改 b 的 k 与 sub.z,a 和同样引用 *base 的 c 纹丝不动。想靠别名共享可变引用,在这一页是行不通的。

入表的时机也有细节:存锚点排在标签 cast 之前。a: &s !!str 42 之后再写 b: *s,得到的是 {"a":"42","b":42}——a 键下的值被 cast 成字符串,入表的却是未 cast 的数字,别名取回 42。

别名也不压缩。同一锚点被引用 1、3、10 次,美化输出分别是 130、256、697 字符,每多一次引用加 63 字符,且与手工内联展开的输出逐字节相同。

a: &base 存表前克隆 1 b: *base 取用时再克隆 副本 b===a false,b.sub===a.sub false 引用 1/3/10 次输出 130/256/697 字符 每多一次引用 +63 字符

图 1 双克隆链与展开账:两刀之后别名与原件互不相干,引用次数按 63 字符一份线性铺开。

合并键:merged 先铺,own 后写

<< 的落位规则是先把合并来源铺平、再写本层自有键,同名时 own 赢。序列档 <<: [*m1, *m2] 则倒序铺平:m2 先铺、m1 后铺,同名反而是靠前的别名赢。合并进来的值同样又是克隆,别名取到的仍不是原件本体。

写法实测输出账
<<: *base 加同名 own 键键序 x,y,z,y=9merged 先铺、own 覆盖
<<: [*m1, *m2]x=1,键序 3 个倒序铺平,靠前别名赢
同一映射写两行 <<x=2按出现序 push,后者覆盖
三层链 d: {<<: *a}一次展开满 3 键锚点存的已是展开完的克隆
<< 指标量或数组键照常输出,只警告数组按元素各报一条

非映射目标的警告原文是「合并键 << 引用的不是映射,已跳过」;数组档两个元素就逐字报两条同文,不升级为错误。

块标量:六档各有一本尾换行账

用两行内容加两个空行再接一个键的同一排本量六档:逐字输出长 10、9、10、9、5、9 字符。尾随换行上,| 与 > 各留 1 个,|- 与 >- 归零,|+ 留 3 个(空行数加补的 1 个);若输入以 |+ 块直接收尾,只剩 2 个——最末空段在切行时已被去掉。折叠档 > 把相邻普通行的接缝换成空格,空行折成 1 个换行,行首带空格的行强制走换行档。

同一块体 · 尾随换行数 |- 0 | 与 > 1 EOF 收场 |+ 2 |+ 3(空行数 +1) 显式缩进 |2 按 parent+2 切片 |1 每行残留 1 个前导空格 多缩部分原样保留

图 2 块标量两本账:左边是 chomping 尾换行,右边是显式缩进指示的切片口径。

显式缩进与报错也各有原文:|2 按上级加 2 切片,内容多缩的部分原样保留;|1 让每行残留 1 个前导空格;写成 |0 或 |x 报「块标量标记后面只能有 1-9 的缩进数字和 - + 修饰符」;|9 缩进不足报「要求至少 9 个空格」那句,message 全长 44 字符、UTF-8 下 108 字节;自动档参差报「块标量的缩进比第一行内容少 1 个空格」。空块 k: | 紧跟同级键得到空串。

锚点作用域:逐文档重建的别名表

别名表活不过文档边界:每切一份文档就重建一次,两次解析调用之间同样零状态。于是自引用构造不出死循环——a: &a 的块档里写 y: *a 报「第 3 行:引用了未定义的锚点 *a」,流式与序列档同样报错,因为锚点要等整个值解析完才入表。跨文档借用也一样,界面按原文行号报「第 4 行:引用了未定义的锚点 *x」;同名 &x 在下一份文档重定义则各自引用互不串。

多文档开关改变的是壳而非账:未勾选时三个文档一起报「输入包含 3 个文档(出现了多个 ---)」,输出为空串,这句提示挂在 line 0 上、没有行列元信息;勾选后得到 3 元素数组。若某文档自身先炸(例如上面那个跨文档引用),界面报的是该文档的别名错而不是文档数错。空串与只有注释的输入也各算 1 个文档、值为 null;--- k: v 同行写法会被改写成 4 空格缩进行照 parse。

# 与冒号的归属,顺带两档布尔

# 要行首或空白领头才成注释:http://x#y 整串保留,b#c 粘着不算注释,1#c 因此连数字都当字符串;引号里的 # 全是内容。冒号只认「后跟空白或行尾」,所以 a:b: c 的键是 a:b。严格与宽松两档在 yes/on/Off/Y/n/true/null 的样本上翻转 3 个键的类型;严格档其实仍认 True/TRUE/false/FALSE 变体,页面文案那句「布尔只认 true/false」只能算部分一致。

界面全链路在 DOM 桩里跑过:内置示例 YAML 输出 1166 字符,统计行逐字是节点数 45、最大深度 7、文档数 1、键 34、数组项 10;报错面板分标题、行列、正文、原文指向、建议五段,列号等于该行缩进加 1,第 2 行的别名未定义错渲染出「第 2 行 第 3 列」。四个开关每次 change 都同步落 localStorage 再重跑。浏览器真实绘制与输入防抖合并本批未开浏览器,标未实测。

常见问题

Q:改别名取到的值,原件会跟着变吗?

不会。入表与取用各克隆一次,别名与原件深两层都不共享对象,改副本动不了原件,也轮不到别的别名。

Q:合并键和本层同名键谁赢?

own 赢——merged 先铺、own 后写。但序列档 <<: [*m1, *m2] 内部是倒序铺平,两份来源同名时靠前的那份赢。

Q:上一份文档定义的锚点,这份接着用行不行?

不行,别名表逐文档重建,跨文档引用只会得到「引用了未定义的锚点」;想复用就在本文档内重新定义。

以上账都在 YAML JSON 转换页内核上实测;拿不准 JSON 侧输出档位时,可在 JSON 格式化页对照美化与压缩两档的字节差;本页标量类型解析那条线(布尔词表与数字判定)旧文已量过,见 YAML 标量类型重写,本篇不重做那张表。

📎 相关文章

格式化 SQL 后粘贴回来逐字节一样吗:8 种字符串写法对拍全等,2 个未闭合反引号却静默配对 2026-11-20 7 个 tab 出 84 格字段名:2nd_field 有 6 种写法,5 个开关只动 Java 一栏 2026-11-20 Excel转JSON只认2条数字正则:0012变12、1e5仍是串,8格开关矩阵99到192字节 2026-11-20 3.7 读成 3、1e3 读成 1:分数计算器这一页先在输入端截成整数,再在 14 个字符处换显示口径 2026-11-14 后缀只切最后一个点:archive.tar.gz 分走 gz,photo. 和 .gitignore 挤进同一格,表格首列还会掉一个点 2026-11-14