線上TOML轉JSON工具

什麼是 TOML 和 JSON？什麼時候需要轉換？

一個軟體專案的配置檔案用 TOML 格式（比如 config.toml）寫好了，但部署系統只認 JSON，這時候就需要把 TOML 轉成 JSON。TOML（Tom's Obvious, Minimal Language）是一種專門寫配置的輕量格式，常見於 Rust 的 Cargo.toml、Python 的 pyproject.toml 中。JSON（JavaScript Object Notation）是幾乎所有程式語言和 API 都支援的資料交換格式。在我們的線上轉換工具裡，你只需把 TOML 文字貼上到左側輸入框，點選“轉換”按鈕，右側就會輸出 JSON。

典型使用場景

• 部署配置遷移：你在本地用 TOML 寫了開發配置，但伺服器只接受 JSON 格式的環境變數檔案。用這個工具轉換一次，複製結果到伺服器即可。
• 資料匯入匯出：某個第三方 API 或資料庫只支援 JSON 格式的配置，而你手頭只有 TOML 檔案。用工具轉成 JSON 後直接提交。
• 團隊協作演示：向不熟悉 TOML 的同事分享配置示例時，轉成 JSON 能讓更多人直觀理解結構。

完整轉換示例

主算例：一份標準的 TOML 配置：

[server]
host = "127.0.0.1"
port = 8080

[database]
name = "testdb"
user = "admin"
password = "secret"

[features]
enable_ssl = true
allow_guests = false

在工具的“輸入 TOML”框中貼上以上內容，點選“轉換”，右側會顯示：

{
  "server": {
    "host": "127.0.0.1",
    "port": 8080
  },
  "database": {
    "name": "testdb",
    "user": "admin",
    "password": "secret"
  },
  "features": {
    "enable_ssl": true,
    "allow_guests": false
  }
}

對照例：包含陣列和日期時間的 TOML：

title = "Example"
numbers = [1, 2, 3]
created = 2023-08-15T10:00:00Z

轉換後 JSON 中，日期變成了字串：

{
  "title": "Example",
  "numbers": [1, 2, 3],
  "created": "2023-08-15T10:00:00Z"
}

注意 TOML 的陣列原樣保留，但日期被轉成 ISO 8601 字串（JSON 本身沒有日期型別）。

結果怎麼解讀

轉換成功後的 JSON 可以直接複製使用。你需要關注幾個差異：

• 鍵名保持不變，但 TOML 中使用點分隔的鍵（如 a.b.c）會變成巢狀的 JSON 物件。
• 表陣列（如 [[items]]）在 JSON 中變成物件陣列，順序與原 TOML 中出現順序一致。
• 註釋丟失：TOML 的 # 註釋在 JSON 中不存在，轉換後會被全部丟棄。

如果輸入 TOML 有語法錯誤（如重複鍵、縮排不對），工具會顯示錯誤提示，不會輸出 JSON。

常見誤用和易踩的坑

1. 忘記轉義特殊字元：TOML 字串內的雙引號必須用反斜槓轉義，否則解析失敗。例如 say = "他問："你好"" 應該寫成 say = "他問：\"你好\""。
2. 混淆整數與浮點數：TOML 中 5 是整數，5.0 是浮點數；JSON 會如實區分，不能混用。
3. 依賴註釋說明：如果配置檔案中用註釋解釋欄位含義，轉換後註釋丟失，容易誤解。建議轉換前備份原始檔案。
4. 表陣列合併順序：如果同一個表陣列出現在兩個不同位置（如 [[items]] 在檔案頭和檔案尾重複），TOML 規範會合並它們，導致 JSON 陣列順序與預期不符。
5. 非標準日期格式：TOML 要求嚴格日期格式（如 2023-08-15T10:00:00Z），如果寫成 08/15/2023 會被當作普通字串。

常見問題 FAQ

1. 我的 TOML 包含中文能正常轉換嗎？可以。TOML 和 JSON 都支援 UTF-8 編碼，中文會原樣保留。
2. 轉換後的 JSON 和原 TOML 完全等價嗎？不完全等價。JSON 沒有註釋、日期型別會變成字串、不支援隱式表結構。關鍵資料一致，但元資訊丟失。
3. 工具支援一次性轉換多個 TOML 檔案嗎？目前只支援貼上單段文字。如果需要批次處理，建議使用命令列工具（如 toml2json）。
4. 為什麼我的 TOML 報語法錯誤？檢查縮排是否使用空格（不要用 Tab）、鍵是否重複、字串是否轉義。也可以去線上 TOML 驗證器先檢測。
5. 轉換後的 JSON 能否得到壓縮版本（去掉空格）？預設輸出是帶縮排的美化格式。如果需要壓縮版，可以把結果複製到任意 JSON 壓縮工具處理。
6. 如果 TOML 包含敏感資訊（如密碼）轉換安全嗎？工具只執行在瀏覽器中，不會上傳你貼上的內容到伺服器。但爲了絕對安全，建議在離線環境下使用。

注意事項與侷限

• 本工具嚴格遵循 TOML v1.0.0 規範，但不支援部分邊緣特性（如行尾反斜槓續行、內聯表內的多餘空格）。遇到不支援的語法會提示錯誤。
• 數字精度受限於 JavaScript 的 Number 型別，超過 2^53 的整型數值可能丟失精度。
• 轉換結果僅供參考或臨時使用；涉及生產環境的關鍵配置，建議手動覈對轉換後的 JSON。
• 如果工具無法正常轉換，請嘗試將 TOML 內容簡化後分步轉換。

現在你可以在上方計算器裡試試自己的 TOML 檔案。