了解 JSON 結(jié)構(gòu)

JSON（JavaScript 物件表示法）是一種輕量級資料交換格式，易於人類閱讀和編寫，也易於機(jī)器解析和產(chǎn)生。它由兩個(gè)基本結(jié)構(gòu)組成：

1. 物件：用大括號 {} 括起來的鍵/值對的集合。

   • 範(fàn)例：{ "name": "John", "age": 30 }

2. 陣列：用方括號 [] 括起來的有序值集合。

   • 例：[「蘋果」、「香蕉」、「櫻桃」]

常見 JSON 錯(cuò)誤

在開始修復(fù)和驗(yàn)證 JSON 之前，讓我們先了解 JSON 可能遇到的常見問題：

1. 缺少或多餘的逗號：陣列或物件末端的尾隨逗號或缺少逗號可能會導(dǎo)致無效的 JSON。

   • 無效的 JSON: { "name": "John", "age": 30, }
   • 正確的 JSON: { "name": "John", "age": 30 }

2. 不含引號的鍵：JSON 鍵必須永遠(yuǎn)用雙引號 (") 括起來。

   • 無效的 JSON: { name: "John" }
   • 正確的 JSON: { "name": "John" }

3. 不正確的資料類型：確保正確使用資料型態(tài)。例如，字串應(yīng)該加引號，數(shù)字應(yīng)該不加引號。

   • 無效的 JSON: { "age": "30" } （年齡被引用，但它應(yīng)該是一個(gè)數(shù)字）
   • 正確的 JSON: { "age": 30 }

4. 括號不符：請務(wù)必確保大括號 {} 和方括號 [] 正確匹配。

   • 無效的 JSON: { "name": "John", "age": 30
   • 正確的 JSON: { "name": "John", "age": 30 }

5. 無效字元：JSON 字串只能包含某些字元。例如，反斜線 () 必須在字串中轉(zhuǎn)義。

   • 無效的 JSON: { "quote": "這是一個(gè)反斜線 \" }
   • 正確的 JSON: { "quote": "這是一個(gè)反斜線 \\" }

如何修復(fù) JSON

要修復(fù)無效的 JSON，您可以按照以下步驟操作：

1. 手動(dòng)修復(fù) JSON

如果您有一小段無效的 JSON，最簡單的方法可能是手動(dòng)修復(fù)它。這是一個(gè)簡單的方法：

• 第 1 步：辨識並修正語法錯(cuò)誤（例如缺少逗號、括號或引號）。
• 第 2 步：確保所有鍵都用雙引號括起來，並且值的類型正確（字串、數(shù)字、布林值、陣列、物件、null）。
• 第 3 步：使用 JSON 驗(yàn)證器（更多內(nèi)容請見下文）來確認(rèn)您的 JSON 結(jié)構(gòu)正確。

2. 使用線上工具修復(fù) JSON

有幾個(gè)線上工具可以幫助您自動(dòng)修復(fù)或格式化 JSON：

• JSONLint (https://onlinejsonformatter.com) – 它檢查 JSON 的語法並突出顯示錯(cuò)誤。它還可以將雜亂的 JSON 格式化為可讀的結(jié)構(gòu)。
• JSON 格式化程式和驗(yàn)證器 (https://jsonformatter.curiousconcept.com/) – 此工具可協(xié)助格式化 JSON 並提供錯(cuò)誤描述。
• JSON Prettifier – 它可以幫助清理並使 JSON 更具可讀性。

這些工具通常會突出顯示語法問題並提供錯(cuò)誤訊息，可以引導(dǎo)您準(zhǔn)確找到問題所在，從而更容易修復(fù)。

3. 使用支援 JSON 的程式碼編輯器

許多程式碼編輯器（例如 Visual Studio Code、Sublime Text 或 Atom）提供特定於 JSON 的功能，例如：

• 語法突出顯示：顏色和格式可幫助您直觀地看到不匹配的括號或引號。
• Linting：ESLint 或 TSLint 等工具可以幫助標(biāo)記 JSON 檔案中的問題。
• 自動(dòng)格式化：VSCode 等編輯器具有內(nèi)建格式化程序，可自動(dòng)修復(fù) JSON 縮排並刪除無關(guān)的空格。

VS Code 中的範(fàn)例：

1. 開啟您的 JSON 檔案。
2. 點(diǎn)選 Shift Alt F 自動(dòng)格式化並修正常見的間距問題。
3. 使用像 Prettier 這樣的擴(kuò)充功能來進(jìn)一步格式化 JSON。

4. 使用程式語言修復(fù) JSON

如果您有大型資料集，使用程式語言（例如 Python、JavaScript 或 Go）可能會更有效。例如，在 Python 中，您可以使用 json 模組來驗(yàn)證和修復(fù) JSON：

import json

# Read the JSON string from a file or input
input_json = '{"name": "John", "age": 30,}'

# Try to load and fix the JSON
try:
    parsed_json = json.loads(input_json)  # This will raise an error if the JSON is invalid
except json.JSONDecodeError as e:
    print(f"Invalid JSON: {e}")

# Correcting it manually or programmatically and revalidating

在 JavaScript 中，您可以使用 JSON.parse() 檢查 JSON 是否有效，然後修改它：

const inputJson = '{"name": "John", "age": 30,}';

try {
    const parsedJson = JSON.parse(inputJson); // Throws error if invalid
    console.log('Valid JSON:', parsedJson);
} catch (error) {
    console.log('Invalid JSON:', error.message);
}

驗(yàn)證 JSON

JSON 驗(yàn)證涉及檢查 JSON 字串的結(jié)構(gòu)和格式是否正確。這可以透過多種方式完成：

1. 使用 JSON 驗(yàn)證器

網(wǎng)路上有幾個(gè)免費(fèi)的 JSON 驗(yàn)證工具：

• JSONLint：將 JSON 貼到框中，然後按一下「驗(yàn)證 JSON」。它將顯示您的 JSON 是否有效或突出顯示無效的地方。
• JSON Formatter & Validator：該工具不僅可以驗(yàn)證，還可以以可讀的方式格式化 JSON。

2. 使用程式語言進(jìn)行驗(yàn)證

大多數(shù)程式語言都有用於驗(yàn)證 JSON 的內(nèi)建函數(shù)或函式庫：

• Python：

import json

# Read the JSON string from a file or input
input_json = '{"name": "John", "age": 30,}'

# Try to load and fix the JSON
try:
    parsed_json = json.loads(input_json)  # This will raise an error if the JSON is invalid
except json.JSONDecodeError as e:
    print(f"Invalid JSON: {e}")

# Correcting it manually or programmatically and revalidating

• JavaScript：

const inputJson = '{"name": "John", "age": 30,}';

try {
    const parsedJson = JSON.parse(inputJson); // Throws error if invalid
    console.log('Valid JSON:', parsedJson);
} catch (error) {
    console.log('Invalid JSON:', error.message);
}

• 去：

  import json

  try:
      json_object = json.loads('{"name": "John", "age": 30}')
      print("Valid JSON")
  except ValueError as e:
      print("Invalid JSON", e)

3. 使用 JSON 模式驗(yàn)證

對於更複雜的 JSON 結(jié)構(gòu)，您可以根據(jù)預(yù)先定義的 JSON 架構(gòu) 驗(yàn)證 JSON。 JSON 架構(gòu)是定義 JSON 文件的結(jié)構(gòu)、所需屬性和資料類型的藍(lán)圖。

• JSON 架構(gòu) 就像一個(gè)合約，定義了有效的 JSON 應(yīng)該是什麼樣子。
• JavaScript 或 Python jsonschema 庫中的 AJV（另一個(gè) JSON 架構(gòu)驗(yàn)證器）等工具可以幫助您根據(jù)架構(gòu)驗(yàn)證 JSON 資料。

範(fàn)例 JSON 架構(gòu):

  try {
      JSON.parse('{"name": "John", "age": 30}');
      console.log("Valid JSON");
  } catch (e) {
      console.log("Invalid JSON");
  }

使用 Schema 在 Python 中驗(yàn)證 JSON:

  import (
      "encoding/json"
      "fmt"
  )

  func main() {
      var jsonData = `{"name": "John", "age": 30}`
      var obj map[string]interface{}

      err := json.Unmarshal([]byte(jsonData), &obj)
      if err != nil {
          fmt.Println("Invalid JSON:", err)
      } else {
          fmt.Println("Valid JSON")
      }
  }

自動(dòng) JSON 驗(yàn)證

對於持續(xù)整合、自動(dòng)化測試或生產(chǎn)環(huán)境，您可能想要使用建置工具或 CI 管道（如 GitHub Actions、Jenkins 等）自動(dòng)進(jìn)行 JSON 驗(yàn)證。

• 您可以使用 JSONLint、prettier 等工具，或使用程式語言編寫自訂驗(yàn)證腳本並將其整合到您的工作流程中。

結(jié)論

修復(fù)和驗(yàn)證 JSON 對於開發(fā)人員來說是一項(xiàng)關(guān)鍵技能，尤其是在使用 API、設(shè)定檔或系統(tǒng)之間的資料交換時(shí)。無論您使用小型 JSON 物件還是大型資料集，了解常見陷阱、使用線上工具、程式語言或 JSON 架構(gòu)驗(yàn)證都可以顯著提高 JSON 資料的可靠性和正確性。

透過使用正確的工具，例如線上驗(yàn)證器、具有內(nèi)建功能的程式碼編輯器，甚至使用腳本自動(dòng)化流程，您可以確保您的JSON 格式化程式 既有效又易於使用.

以上是輕鬆修復(fù)和驗(yàn)證 JSON：深入指南的詳細(xì)內(nèi)容。更多資訊請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！