TOML 轉 JSON 轉換器
在 TOML 與 JSON 這兩種設定檔格式之間互相轉換。
使用範例
閱讀 Rust 或 Python 專案設定
像 Cargo.toml、pyproject.toml 這類設定檔,轉成 JSON 後更容易檢查巢狀數值,或丟進其他工具使用。
將設定檔遷移成 TOML
手上的設定是 JSON,但新工具要求 TOML 格式?貼上 JSON,即可取得表格與陣列都排列正確的 TOML 檔案。
檢視 GitHub Actions 或 CLI 工具的 TOML 設定
先把 TOML 設定轉成 JSON,就能快速與其他環境的設定做比對,或貼進以 JSON 為基礎的腳本中使用。
手動撰寫 GitHub Actions 或 Cargo 設定
如果比較習慣,可以先以 JSON 草擬結構,再轉換成 TOML,用於需要它的 Cargo.toml 或類似檔案。
查看 TOML 的表格陣列在 JSON 中是什麼樣子
將使用「[[section]]」表格陣列語法的 TOML 檔案轉換成 JSON,清楚看出它會變成單純的 JSON 物件陣列。
快速參考
TOML 轉 JSON
| TOML | JSON |
|---|---|
| title = "TOML" | {"title":"TOML"} |
| lit = 'C:\path' | {"lit":"C:\\path"} |
| port = 8080 | {"port":8080} |
| big = 1_000_000 | {"big":1000000} |
| hex = 0xff | {"hex":255} |
| oct = 0o755 | {"oct":493} |
| bin = 0b1101 | {"bin":13} |
| pi = 3.14 | {"pi":3.14} |
| exp = 5e+22 | {"exp":5e+22} |
| enabled = true | {"enabled":true} |
| date = 1979-05-27 | {"date":"1979-05-27"} |
| dt = 1979-05-27T07:32:00Z | {"dt":"1979-05-27T07:32:00.000Z"} |
| time = 07:32:00 | {"time":"07:32:00.000"} |
| arr = [1, 2, 3] | {"arr":[1,2,3]} |
| mixed = [1, "a"] | {"mixed":[1,"a"]} |
| inline = { x = 1, y = 2 } | {"inline":{"x":1,"y":2}} |
| a.b.c = 1 | {"a":{"b":{"c":1}}} |
| "quoted key" = 1 | {"quoted key":1} |
| [server]\nhost = "localhost" | {"server":{"host":"localhost"}} |
| [[items]]\nid = 1\n[[items]]\nid = 2 | {"items":[{"id":1},{"id":2}]} |
| s = """\nline1\nline2""" | {"s":"line1\nline2"} |
JSON 轉 TOML
| JSON | TOML |
|---|---|
| {"a": "text"} | a = "text" |
| {"a": 1.5} | a = 1.5 |
| {"a": "2024-01-15"} | a = "2024-01-15" |
| {"a b": 1} | "a b" = 1 |
| {"a": [1, "x"]} | a = [ 1, "x" ] |
| {"a": []} | a = [] |
| {"a": {"b": 1}} | [a]\nb = 1 |
| {"a": {}} | [a] |
| {"items": [{"id": 1}, {"id": 2}]} | [[items]]\nid = 1\n\n[[items]]\nid = 2 |
| {"a": null, "b": 1} | b = 1 (提醒:TOML 沒有原生的 null 值,因此值為 null 的鍵已從輸出結果中省略。) |
| [1, 2] | 轉換錯誤: stringify can only be called with an object |
常見問題
我的資料會被傳送到伺服器嗎?
不會。轉換完全在你的瀏覽器中使用 smol-toml 函式庫進行,貼上的任何內容都不會上傳到任何地方。
把 JSON 轉成 TOML 時,'null' 值會發生什麼事?
TOML 沒有原生方式表示 null。值為 null 的鍵會被靜默地從產生的 TOML 中移除,而不會導致錯誤。如果需要保留這項資訊,建議在轉換前以替代值(例如空字串或布林旗標)取代 null。
所有 JSON 結構都能轉換成 TOML 嗎?
大多數可以,包括巢狀物件(對應為 TOML 表格)與陣列。不過 TOML 在同一陣列中混合不同型別,以及頂層值不是物件的情況下,彈性不如 JSON,因此較特殊的結構可能轉換失敗——錯誤訊息會說明問題所在。
轉換器會保留鍵的順序嗎?
會,兩個方向的轉換都會保留鍵在原始文件中出現的順序。
轉換器支援 TOML 的日期與時間型別嗎?
支援。TOML 原生的日期、時間與日期時間值,會在 JSON 中轉換成其 ISO 8601 字串表示,因為 JSON 沒有原生的日期型別。
TOML 的表格與行內表格有什麼差別?
一般表格(「[section]」)會開始一個新的區塊,後續的鍵都屬於它;而行內表格(「{ key = value }」)則是精簡的單行物件。兩者都會轉換成相同類型的巢狀 JSON 物件。
可以只轉換 TOML 檔案的一部分嗎?
輸入本身必須是完整且有效的 TOML 文件,貼上依賴檔案其餘部分脈絡的獨立片段(例如沒有表格標頭的單純鍵清單),可能會剖析失敗。