雜記 › 技術筆記 › YAML 錨點別名是副本:引用 10 次展開成 697 字元,合併鍵同名時 own 壓過 merged

YAML 錨點別名是副本:引用 10 次展開成 697 字元,合併鍵同名時 own 壓過 merged

這頁 YAML 解析器的錨點別名要挨兩刀克隆才拿到副本,引用 1、3、10 次展開成 130、256、697 字元;合併鍵 merged 先鋪 own 後寫;塊標量六檔的尾換行與跨文件錨點報錯逐條入賬。

錨點入表要挨兩刀:別名拿到的是副本

/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