TOML 轉 JSON 轉換器
將 TOML 設定檔轉換為 JSON 格式,可將人類易讀的屬性設定轉換為網頁應用程式能快速解析的嚴格資料物件。
格式比較與技術規格
| 規格 | TOML | JSON |
|---|---|---|
| MIME 類型 | application/ | application/ |
| 類型 | 極簡設定檔 | 結構化資料物件 |
| 壓縮 | 無(UTF-8 文字) | 無(文字串流) |
| 標準規格 | TOML v1.0.0 規格 | IETF RFC 8259 / ECMA-404 |
| 檔案簽章(magic bytes)標頭 | [section] key = "value" | 7B (\{) or 5B (\[) JSON root delimiter |
格式概述與應用
TOML 與 JSON 都用於儲存設定,但它們在軟體專案中扮演不同的角色。開發人員通常會以 TOML 編寫設定檔,因為它支援註解且手動輸入時感覺很自然。不過,網頁瀏覽器與許多程式庫更偏好 JSON,因為它是廣泛使用的資料交換標準。 當建置工具或部署管線需要讀取本機設定時,將 TOML 轉換為 JSON 就能彌補這項落差。例如,現代的靜態網站產生器通常接受 TOML 輸入作為使用者偏好設定,但需要 JSON 輸出將資料饋送至 JavaScript 前端。轉換檔案結構可讓自動化指令碼取用設定值,而不需要專門的 TOML 解析器。
技術規格與編解碼器解析
TOML 代表 Tom's Obvious, Minimal Language,其指定 MIME 類型為 application/toml。它使用純 UTF-8 文字,包含鍵值對、區段與原生日期型別。JSON 代表 JavaScript Object Notation,其指定 MIME 類型為 application/json。預設情況下,這兩種格式都不使用壓縮,這意味著兩者皆為原始文字串流。無論是 TOML 還是 JSON,都不依賴檔案簽章(magic bytes)標頭。相反地,它們依賴結構標記(例如 JSON 中的大括號或 TOML 中帶有方括號的標題)來向解析器標示其格式。轉換過程會讀取 TOML 鍵值階層,並將其直接對應至標準的 JSON 物件與陣列。
作業系統與瀏覽器相容性
TOML 與 JSON 都是文字格式,但應用程式支援度各有不同。瀏覽器可以使用 JavaScript 解析 JSON,而 TOML 則需要解析器。
實用資訊
請記住,TOML 支援使用井字號(#)的註解,而標準 JSON 完全不支援註解。TOML 來源檔案中存在的任何註解在轉換為 JSON 期間都會被移除。
常見問題
如何將 TOML 設定轉為 JSON 設定而不會遺失品質?
此轉換對鍵與值而言是無損的,因為這兩種格式都表示基於文字的設定資料。不會發生資料壓縮,因此所有鍵、字串、數字與布林值都會直接轉移至新結構中,而不會降低精確度。
TOML 設定與 JSON 設定有什麼區別?
TOML 專為人類易讀而設計,並提供註解支援與原生日期類型等功能。JSON 專為機器解析與網頁傳輸而設計,使用巢狀大括號與雙引號鍵的嚴格結構,且不允許註解。