锚点入表要挨两刀:别名拿到的是副本
/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 字符,且与手工内联展开的输出逐字节相同。
图 1 双克隆链与展开账:两刀之后别名与原件互不相干,引用次数按 63 字符一份线性铺开。
合并键:merged 先铺,own 后写
<< 的落位规则是先把合并来源铺平、再写本层自有键,同名时 own 赢。序列档 <<: [*m1, *m2] 则倒序铺平:m2 先铺、m1 后铺,同名反而是靠前的别名赢。合并进来的值同样又是克隆,别名取到的仍不是原件本体。
| 写法 | 实测输出 | 账 |
|---|---|---|
<<: *base 加同名 own 键 | 键序 x,y,z,y=9 | merged 先铺、own 覆盖 |
<<: [*m1, *m2] | x=1,键序 3 个 | 倒序铺平,靠前别名赢 |
同一映射写两行 << | x=2 | 按出现序 push,后者覆盖 |
三层链 d: {<<: *a} | 一次展开满 3 键 | 锚点存的已是展开完的克隆 |
<< 指标量或数组 | 键照常输出,只警告 | 数组按元素各报一条 |
非映射目标的警告原文是「合并键 << 引用的不是映射,已跳过」;数组档两个元素就逐字报两条同文,不升级为错误。
块标量:六档各有一本尾换行账
用两行内容加两个空行再接一个键的同一排本量六档:逐字输出长 10、9、10、9、5、9 字符。尾随换行上,| 与 > 各留 1 个,|- 与 >- 归零,|+ 留 3 个(空行数加补的 1 个);若输入以 |+ 块直接收尾,只剩 2 个——最末空段在切行时已被去掉。折叠档 > 把相邻普通行的接缝换成空格,空行折成 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 标量类型重写,本篇不重做那张表。