不用把 YAML 貼進伺服器就能轉換

Q: 我的 YAML 裡寫的是 no，JSON 出來卻是字串。為什麼？

因為它本來就是字串，而這裡讀的是 YAML 1.2，不是 1.1。在 YAML 1.1 裡，yes、no、on 和 off 都是布林值，這就是那個著名的坑：挪威的國家程式碼會變成 false。YAML 1.2 把這條丟掉了，這裡也一樣：只有 true、false、null 和 ~ 會被當成文字之外的東西讀。反過來的時候，這些詞會帶引號寫回去--哪怕這裡不帶引號也照樣當文字讀--因為下一個開啟這份檔案的東西未必如此。PyYAML 到現在預設還是 1.1。嚴格地讀、保守地寫，是兩邊都對的唯一組合。

Q: 它會保持我的鍵順序嗎？

會，兩個方向都會，而這比聽起來難。建立在 JSON.parse 上的轉換器會悄悄把看起來像整數的鍵挪到前面，於是 {"10":a,"2":b} 回來就成了 {"2":b,"10":a}。數字保留你打的每一位，所以一個二十位的帳號不會因為雙精度浮點丟掉最後三位。如果你就是想排序，有個勾選框，而且它按鍵讀起來的樣子排，不是按碼位。

Q: 能一次轉換好幾份 YAML 文件嗎？

不能，而且它會直說，而不是替你挑一份。帶 --- 分隔符的檔案裝著不止一份文件，而 JSON 沒有哪種形狀表示「好幾份文件」--用陣列的話，就成了這份檔案從沒做過的斷言。一份一份轉。

這條隱私承諾怎麼核實

你貼進來的東西沒有出去的路。Content-Security-Policy 裡寫著這個頁面允許聯絡的每一個地址，沒有一個屬於本站。這裡沒有任何可以收走一份貼進來的配置的接收端，就算有，程式碼裡也沒有把它送過去的東西。

這裡不會去取任何東西。src/ 裡哪裡都沒有 fetch，沒有 XMLHttpRequest，也沒有 sendBeacon。兩個解析器和兩個列印器都是這個頁面裡的函式：進去一段字串，出來一段字串。

它讀的是 YAML 1.2，所以挪威還是挪威。在 YAML 1.1 裡，no 是個布林值，這就是那個著名的坑：挪威的國家程式碼會變成 false。這裡讀的是 1.2，在那裡它就是它看上去的那個字串。反過來的時候，這些詞會帶引號寫回去，因為下一個開啟這份檔案的東西可能還是個 1.1 的讀取器。tests/js/text-convert.test.js 兩頭都查。

沒法誠實的轉換，寧可停下來。YAML 裡的錨點、別名或者標籤，會帶著「它在第幾行」的提示結束這次轉換，而不是給你一份悄悄變了意思的 JSON 文件。JSON 沒有辦法表達「同一個節點用兩次」，而挑一種解釋，就是替你做主。

Google 載入了什麼，又沒拿到什麼。廣告和統計指令碼來自 Google，捐贈按鈕來自 Buy Me a Coffee。它們誰也沒拿到你文字裡的一個字元。讀它、解析它、寫它的每一行程式碼，都從這個源提供，也都列在儲存庫裡。

斷網可用。拔掉網線，這個工具一點變化都沒有，因為它裡面本來就沒有聯網這一步。這是最簡單的證明。

你可以自己核對。上面這些不用你信。這個頁面是儲存庫裡的模板和配置產生出來的，構建指令碼你能讀，也能自己跑一遍，跑出來的結果就提交在 dist 分支上。拿實際發給你的內容，跟你自己從原始碼構建出來的結果對一遍就知道了：

github.com/A-Box-of-Tools/website

最值得先讀的幾個檔案：config/site.toml 裡是 Content-Security-Policy，寧可拒絕一個錨點也不去猜它想說什麼的讀取器在 src/shared/parse-yaml.js；一次轉換為什麼就是一個解析器加一個列印器、中間沒有任何同時認得兩種格式的東西，在 src/convert.js。

如果公司的安全軟體警告說有上傳。它盯著瀏覽器裡選擇檔案的那一刻，而且無法知道頁面是否打算把它發出去——所以在選擇時就發出警告。這裡什麼都不會發出去：開啟瀏覽器的開發者工具，切到網路，然後選一個檔案。沒有任何請求帶著它，除了這個頁面自己的本地預覽之外，根本沒有任何請求。同樣的檢查，你們的 IT 同事半分鐘就能做完。

1 選方向

縮排製表符只對 JSON 提供。YAML 是按空格定義的，製表符在它裡面不是合法縮排。

給每個物件的鍵排序 按鍵讀起來的樣子排，而不是按它們的碼位，所以 item2 排在 item10 前面。

轉換

縮排

給每個物件的鍵排序

2 貼進來

把檔案拖到這裡也可以點選選擇——一個 .yaml、.yml 或 .json 檔案

你的 YAML 空的

3 把結果帶走

{reason}（第 {line} 行，第 {column} 列）文字的末尾一個換行一個製表符「{ch}」值結束之後還有 {found} 文字提前結束了鍵必須是雙引號包起來的字串，而這裡是 {found} 鍵後面應該是冒號，找到的是 {found} 沒料到會有 {found} 這裡應該是逗號或右花括號，找到的是 {found} 這裡應該是逗號或右方括號，找到的是 {found} 這個物件一直沒關上這個陣列一直沒關上這個字串一直沒關上 \u 後面必須跟四個十六進位數字 \{next} 不是 JSON 認得的轉義字串裡有個未轉義的控制字元——寫成轉義形式這不是 JSON 允許的數字這一行比它所在的那個塊縮排得還少這個檔案裡不止一個文件。請一個一個地轉。這一行比它上面那個鍵縮排得還多這裡應該是「key: value」不支援別名（*name）— JSON 沒有辦法表達「同一個節點用兩次」不支援標籤（!name）——那樣就得去猜類型這裡不支援「?」鍵「{header}」不是這個讀得懂的塊標量右引號後面還有文字不支援錨點（&name）— JSON 沒有辦法表達「同一個節點用兩次」 \{next} 後面需要 {width} 個十六進位數字 \{next} 不是這個讀得懂的轉義這個帶引號的字串一直沒關上流式集合結束之後還有文字流式集合提前結束了這個流式序列裡應該是逗號或右方括號這個流式對映裡，鍵後面應該是冒號這個流式對映裡應該是逗號或右花括號 YAML 轉 JSON JSON 轉 YAML 註釋會丟，因為 JSON 沒地方放。錨點、別名和標籤會讓轉換停下來，而不是靠猜。什麼都不會丟：每個 JSON 文件本來就已經是 YAML 文件。字串只在不加引號就會變意思的地方才加引號。你的 YAML 你的 JSON 把 YAML 貼上到這裡 - 或者在上面放一個 .yaml、.yml 或 .json 檔案。把 JSON 貼上到這裡 - 或者在上面放一個 .json、.yaml 或 .yml 檔案。 {n} B {n} KB {n} MB 正在讀檔案… 那個檔案讀不了：{reason} 還沒有東西。什麼都沒出來。 {name} — {lines} 行，{size} 複製複製好了已選中——按 Ctrl+C 你的文字沒有去任何地方。載入了 {total} 個檔案。{platform} 有東西聯絡了 {hosts}，而這個工具從不這麼做。{platform} 本站自己用於廣告、統計和捐贈按鈕的指令碼來自 {hosts} 個主機，它們誰也沒拿到其中的一個字。本站自己用於廣告、統計和捐贈按鈕的指令碼來自 {hosts} 個主機，它們誰也沒拿到其中的一個字。

# YAML 轉 JSON — JSON 也能轉回 YAML 兩個方向都有，而且會告訴你各自的代價。這些都不會貼進別人的伺服器。 > 在你的瀏覽器裡把 YAML 轉成 JSON、把 JSON 轉成 YAML。它讀的是 YAML 1.2，所以 yes 和 no 還是字串，而且會明確說出每個方向丟了什麼。什麼都不上傳：一份配置檔案永遠不會離開你的裝置。本頁是一個完全在你的瀏覽器裡執行的互動式工具，地址是 https://abox.tools/zh-TW/yaml-to-json/。你交給它的任何內容都不會被上傳。下面是這個頁面用文字對該工具的全部說明；要使用它，請開啟這個地址。 ## 你的 YAML 和 JSON **不會上傳**。這裡根本沒有伺服器。轉換是對一段字串做算術，就在這裡，在這個頁面上。兩個解析器都是手寫的，都在 `src/` 裡——`shared/parse-yaml.js` 和 `shared/parse-json.js`——除此之外再沒有別的。這個工具壓根就沒有網路功能，沒有要取的，也沒有要發的。這一點在這裡比本站幾乎任何地方都更要緊：一份 YAML 檔案多半是部署配置，而部署配置多半塞滿了主機名、桶名和金鑰。 - ✗ 不上傳 - ✗ 不註冊 - ✗ 無大小限制 - ✓ 斷網可用 - ✓ 開源 ## 不上傳就把 YAML 轉成 JSON 的步驟 1. **選方向。** *YAML 轉 JSON* 或者 *JSON 轉 YAML*。選單下面那行小字會在你貼任何東西之前，而不是之後，告訴你這個方向會丟什麼。 2. **貼進來，或者把檔案放上去。** 能選中能複製的都行。把檔案放到選擇框上，你自己的瀏覽器會讀它並填進輸入框——這裡沒有上傳這一步可以省略——而 `.json` 或 `.yaml` 的字尾順便就把方向定好了。 3. **選縮排。** 兩個空格、四個空格，或者一個製表符。製表符只對 JSON 提供：YAML 是按空格定義的，製表符在它裡面不是合法縮排。 4. **在出錯的地方讀錯誤。** 在這裡失敗的解析器會告訴你它遇到了什麼，在第幾行第幾列，而不是「位置 4193 處有意外的 token」。通常這就夠你修好一份配置檔案，不用再開啟別的東西。 5. **把結果拿走。** 複製，或者下載成檔案，檔名按它出來的格式取。 ## 工具箱裡還有 - [XML 格式化](https://abox.tools/zh-TW/xml-formatter/): 排開了好讀的 XML，壓平了好發的 XML，還有兩個方向的 JSON 轉換。這些都不會貼進別人的伺服器。 - [文字比對](https://abox.tools/zh-TW/text-diff/): 兩段文字進來，每處差異都被標出來，逐行、逐詞。沒有一個字被貼進別人的伺服器。 - [Base64 編碼解碼](https://abox.tools/zh-TW/base64/): Base64、百分號編碼、HTML 實體、十六進位和反斜槓轉義，雙向都行。沒有一個字被貼進別人的伺服器。 - [文字與檔案分享](https://abox.tools/zh-TW/share-text/): 分享只活在這個開著的分頁裡。讀的人從你的瀏覽器直接取得加密內容，關掉分頁就結束——任何伺服器上都不留一點東西。 ## 常見問題 ### 我的 YAML 會被上傳到什麼地方嗎？不會。這個頁面上的兩個解析器和兩個列印器，都是在你自己的瀏覽器裡、你自己的硬體上跑的函式。這個工具壓根就沒有網路功能，從不取任何東西，也從不發任何東西，頁面的 `Content-Security-Policy` 裡寫著它允許聯絡的每一個地址，沒有一個屬於本站。這正是拿它處理部署配置的理由：那種檔案裡塞滿主機名、桶名，偶爾還有某人打算挪走的金鑰，把它貼進別人的轉換器，就是把它給了對方。 ### 把 YAML 轉成 JSON 會丟什麼？註釋，因為 JSON 沒地方放。錨點、別名和標籤會被直接拒絕，而不是靠猜——它們各自說的事情 JSON 都說不出來，一個悄悄挑了種解釋的轉換器，會交給你一份並不是檔案原意的文件。反方向不丟任何東西：每一份 JSON 文件本來就已經是 YAML 文件。 ### 我的 YAML 裡寫的是 no，JSON 出來卻是字串。為什麼？因為它本來就是字串，而這裡讀的是 YAML 1.2，不是 1.1。在 YAML 1.1 裡，`yes`、`no`、`on` 和 `off` 都是布林值，這就是那個著名的坑：挪威的國家程式碼會變成 `false`。YAML 1.2 把這條丟掉了，這裡也一樣：只有 `true`、`false`、`null` 和 `~` 會被當成文字之外的東西讀。反過來的時候，這些詞會*帶引號*寫回去——哪怕這裡不帶引號也照樣當文字讀——因為下一個開啟這份檔案的東西未必如此。PyYAML 到現在預設還是 1.1。嚴格地讀、保守地寫，是兩邊都對的唯一組合。 ### 它會保持我的鍵順序嗎？會，兩個方向都會，而這比聽起來難。建立在 `JSON.parse` 上的轉換器會悄悄把看起來像整數的鍵挪到前面，於是 `{"10":a,"2":b}` 回來就成了 `{"2":b,"10":a}`。數字保留你打的每一位，所以一個二十位的帳號不會因為雙精度浮點丟掉最後三位。如果你*就是想*排序，有個勾選框，而且它按鍵讀起來的樣子排，不是按碼位。 ### 能一次轉換好幾份 YAML 文件嗎？不能，而且它會直說，而不是替你挑一份。帶 `---` 分隔符的檔案裝著不止一份文件，而 JSON 沒有哪種形狀表示「好幾份文件」——用陣列的話，就成了這份檔案從沒做過的斷言。一份一份轉。 ### 這裡為什麼沒有 YAML 格式化？因為 YAML 沒有值得一寫的壓縮形式——短的那種是流式風格，讀不了，而讀不了正是把檔案留成 YAML 這件事的反面。排開 JSON、XML、HTML 和 CSS 是 [JSON 格式化](https://abox.tools/zh-TW/json-formatter/)的工作，而且它也排 YAML。 ### 檔案最大能有多大？這裡沒有設限，因為沒有伺服器在為此付錢。真正的上限是你自己的裝置：幾 MB 的 YAML 沒問題，文件很長的時候，頁面會等你打字停下來再轉換，而不是跟你搶鍵盤。 ### 免費嗎？需要註冊嗎？免費，沒有帳號，不用登入，沒有試用期，也不限制你貼多少。本站有廣告，網站靠它維持；廣告拿不到關於你文字的任何東西。 ### 斷網還能用嗎？能。頁面載入一次之後拔掉網線，它照樣工作。這也是證明沒有上傳的最簡單辦法：一個把你的配置送出去轉換的工具，在你拔線的那一刻就停了。 ## 這條隱私承諾怎麼核實 - **你貼進來的東西沒有出去的路。** Content-Security-Policy 裡寫著這個頁面允許聯絡的每一個地址，沒有一個屬於本站。這裡沒有任何可以收走一份貼進來的配置的接收端，就算有，程式碼裡也沒有把它送過去的東西。 - **這裡不會去取任何東西。** `src/` 裡哪裡都沒有 `fetch`，沒有 `XMLHttpRequest`，也沒有 `sendBeacon`。兩個解析器和兩個列印器都是這個頁面裡的函式：進去一段字串，出來一段字串。 - **它讀的是 YAML 1.2，所以挪威還是挪威。** 在 YAML 1.1 裡，`no` 是個布林值，這就是那個著名的坑：挪威的國家程式碼會變成 `false`。這裡讀的是 1.2，在那裡它就是它看上去的那個字串。反過來的時候，這些詞會*帶引號*寫回去，因為下一個開啟這份檔案的東西可能還是個 1.1 的讀取器。`tests/js/text-convert.test.js` 兩頭都查。 - **沒法誠實的轉換，寧可停下來。** YAML 裡的錨點、別名或者標籤，會帶著「它在第幾行」的提示結束這次轉換，而不是給你一份悄悄變了意思的 JSON 文件。JSON 沒有辦法表達「同一個節點用兩次」，而挑一種解釋，就是替你做主。 - **Google 載入了什麼，又沒拿到什麼。** 廣告和統計指令碼來自 Google，捐贈按鈕來自 Buy Me a Coffee。它們誰也沒拿到你文字裡的一個字元。讀它、解析它、寫它的每一行程式碼，都從這個源提供，也都列在儲存庫裡。 - **斷網可用。** 拔掉網線，這個工具一點變化都沒有，因為它裡面本來就沒有聯網這一步。這是最簡單的證明。 **你可以自己核對。**上面這些不用你信。這個頁面是儲存庫裡的模板和配置產生出來的，構建指令碼你能讀，也能自己跑一遍，跑出來的結果就提交在 `dist` 分支上。拿實際發給你的內容，跟你自己從原始碼構建出來的結果對一遍就知道了： https://github.com/A-Box-of-Tools/website 最值得先讀的幾個檔案：`config/site.toml` 裡是 Content-Security-Policy，寧可拒絕一個錨點也不去猜它想說什麼的讀取器在 `src/shared/parse-yaml.js`；一次轉換為什麼就是一個解析器加一個列印器、中間沒有任何同時認得兩種格式的東西，在 `src/convert.js`。

常見問題

我的 YAML 會被上傳到什麼地方嗎？

不會。這個頁面上的兩個解析器和兩個列印器，都是在你自己的瀏覽器裡、你自己的硬體上跑的函式。這個工具壓根就沒有網路功能，從不取任何東西，也從不發任何東西，頁面的 Content-Security-Policy 裡寫著它允許聯絡的每一個地址，沒有一個屬於本站。這正是拿它處理部署配置的理由：那種檔案裡塞滿主機名、桶名，偶爾還有某人打算挪走的金鑰，把它貼進別人的轉換器，就是把它給了對方。

把 YAML 轉成 JSON 會丟什麼？

註釋，因為 JSON 沒地方放。錨點、別名和標籤會被直接拒絕，而不是靠猜——它們各自說的事情 JSON 都說不出來，一個悄悄挑了種解釋的轉換器，會交給你一份並不是檔案原意的文件。反方向不丟任何東西：每一份 JSON 文件本來就已經是 YAML 文件。

我的 YAML 裡寫的是 no，JSON 出來卻是字串。為什麼？

因為它本來就是字串，而這裡讀的是 YAML 1.2，不是 1.1。在 YAML 1.1 裡，yes、no、on 和 off 都是布林值，這就是那個著名的坑：挪威的國家程式碼會變成 false。YAML 1.2 把這條丟掉了，這裡也一樣：只有 true、false、null 和 ~ 會被當成文字之外的東西讀。反過來的時候，這些詞會帶引號寫回去——哪怕這裡不帶引號也照樣當文字讀——因為下一個開啟這份檔案的東西未必如此。PyYAML 到現在預設還是 1.1。嚴格地讀、保守地寫，是兩邊都對的唯一組合。

它會保持我的鍵順序嗎？

會，兩個方向都會，而這比聽起來難。建立在 JSON.parse 上的轉換器會悄悄把看起來像整數的鍵挪到前面，於是 {"10":a,"2":b} 回來就成了 {"2":b,"10":a}。數字保留你打的每一位，所以一個二十位的帳號不會因為雙精度浮點丟掉最後三位。如果你就是想排序，有個勾選框，而且它按鍵讀起來的樣子排，不是按碼位。

能一次轉換好幾份 YAML 文件嗎？

不能，而且它會直說，而不是替你挑一份。帶 --- 分隔符的檔案裝著不止一份文件，而 JSON 沒有哪種形狀表示「好幾份文件」——用陣列的話，就成了這份檔案從沒做過的斷言。一份一份轉。

這裡為什麼沒有 YAML 格式化？

因為 YAML 沒有值得一寫的壓縮形式——短的那種是流式風格，讀不了，而讀不了正是把檔案留成 YAML 這件事的反面。排開 JSON、XML、HTML 和 CSS 是 JSON 格式化的工作，而且它也排 YAML。

檔案最大能有多大？

這裡沒有設限，因為沒有伺服器在為此付錢。真正的上限是你自己的裝置：幾 MB 的 YAML 沒問題，文件很長的時候，頁面會等你打字停下來再轉換，而不是跟你搶鍵盤。

免費嗎？需要註冊嗎？

免費，沒有帳號，不用登入，沒有試用期，也不限制你貼多少。本站有廣告，網站靠它維持；廣告拿不到關於你文字的任何東西。

斷網還能用嗎？

能。頁面載入一次之後拔掉網線，它照樣工作。這也是證明沒有上傳的最簡單辦法：一個把你的配置送出去轉換的工具，在你拔線的那一刻就停了。