JSON5 和帶註解 JSON：什麼時候可以使用註解和尾隨逗號

標準 JSON 的語法很嚴格。它適合 API、日誌、資料庫欄位和系統之間的資料交換，但不允許註解、尾隨逗號、單引號字串，也不允許不加引號的物件欄位名稱。

很多開發者會困惑，是因為真實專案裡的設定檔經常長這樣：

{
  // 開發環境 API 位址
  apiBaseUrl: 'https://api.example.com',
  retryCount: 3,
  features: {
    betaSearch: true,
  },
}

這不是合法的標準 JSON。它更接近 JSON5，或者類似 JSONC 的帶註解設定格式。當你把這類設定複製到 API 請求、資料庫欄位、環境變數或只支援標準 JSON 的工具裡時，這個差別就會變得很重要。

JSON5 增加了什麼

JSON5 是一種更適合人工編寫設定的寬鬆 JSON 語法。常見特性包括：

這些能力讓設定檔更容易編輯、加註解和程式碼審查。它適合建置工具、編輯器設定、本機腳本和內部設定檔。

標準 JSON 保持更小的語法規則，這樣不同語言裡的解析器才能盡量一致。在嚴格 JSON 中：

例如下面這段會在 JSON.parse() 中報錯：

{
  "name": "MyToolster",
  "enabled": true,
}

僅僅是 true 後面的最後一個逗號，就足以讓整個內容變成非法 JSON。

JSON5 和 JSONC 都是在標準 JSON 基礎上放寬語法，但它們不是同一個契約。

JSON5 是一種明確的寬鬆語法，包含單引號、不加引號的欄位名稱等特性。JSONC 通常指帶註解的 JSON，常見於編輯器設定和工具設定。有些 JSONC 解析器允許尾隨逗號，有些則會根據工具規則拒絕。

所以更穩妥的問題不是「它看起來能不能讀懂」，而是「實際讀取這個檔案的解析器到底支援哪些語法」。

當使用方明確支援 JSON5 或 JSONC 時，帶註解 JSON 是合理的。比如某些編輯器設定、本機工具設定，或專案裡明確說明支援寬鬆 JSON 的解析器。

但下面這些情境通常應該使用標準 JSON：

在這些情境中，傳送資料前應該移除註解和寬鬆語法。

在把寬鬆設定複製到 API、資料庫或正式環境設定前，可以按這個清單檢查：

前面的 JSON5 風格範例轉換成標準 JSON 後是：

{
  "apiBaseUrl": "https://api.example.com",
  "retryCount": 3,
  "features": {
    "betaSearch": true
  }
}

當寬鬆 JSON 被當成標準 JSON 解析時，錯誤通常會指向第一個不支援的字元。常見原因包括：

錯誤訊息不一定會直接說「不支援 JSON5」。它通常只會告訴你哪個字元破壞了標準 JSON 解析。