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

JSON（JavaScript 對(duì)象表示法）是一種輕量級(jí)數(shù)據(jù)交換格式，易于人類閱讀和編寫，也易于機(jī)器解析和生成。它由兩個(gè)基本結(jié)構(gòu)組成：

1. 對(duì)象：用大括號(hào) {} 括起來的鍵/值對(duì)的集合。

   • 示例：{ "name": "John", "age": 30 }

2. 數(shù)組：用方括號(hào) [] 括起來的有序值集合。

   • 示例：[“蘋果”、“香蕉”、“櫻桃”]

常見 JSON 錯(cuò)誤

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

1. 缺少或多余的逗號(hào)：數(shù)組或?qū)ο竽┪驳奈搽S逗號(hào)或缺少逗號(hào)可能會(huì)導(dǎo)致無效的 JSON。

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

2. 不帶引號(hào)的鍵：JSON 鍵必須始終用雙引號(hào) (") 括起來。

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

3. 不正確的數(shù)據(jù)類型：確保正確使用數(shù)據(jù)類型。例如，字符串應(yīng)該加引號(hào)，數(shù)字應(yīng)該不加引號(hào)。

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

4. 括號(hào)不匹配：始終確保大括號(hào) {} 和方括號(hào) [] 正確匹配。

   • 無效的 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，最簡(jiǎn)單的方法可能是手動(dòng)修復(fù)它。這是一個(gè)簡(jiǎn)單的方法：

• 第 1 步：識(shí)別并糾正語法錯(cuò)誤（例如缺少逗號(hào)、括號(hào)或引號(hào)）。
• 第 2 步：確保所有鍵都用雙引號(hào)括起來，并且值的類型正確（字符串、數(shù)字、布爾值、數(shù)組、對(duì)象、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/) – 該工具幫助格式化 JSON 并提供錯(cuò)誤描述。
• JSON Prettifier – 它可以幫助清理并使 JSON 更具可讀性。

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

3. 使用支持 JSON 的代碼編輯器

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

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

VS Code 中的示例：

1. 打開您的 JSON 文件。
2. 單擊 Shift Alt F 自動(dòng)格式化并修復(fù)常見的間距問題。
3. 使用像 Prettier 這樣的擴(kuò)展來進(jìn)一步格式化 JSON。

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

如果您有大型數(shù)據(jù)集，使用編程語言（例如 Python、JavaScript 或 Go）可能會(huì)更有效。例如，在 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)證

對(duì)于更復(fù)雜的 JSON 結(jié)構(gòu)，您可以根據(jù)預(yù)定義的 JSON 架構(gòu) 驗(yàn)證 JSON。 JSON 架構(gòu)是定義 JSON 文檔的結(jié)構(gòu)、所需屬性和數(shù)據(jù)類型的藍(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 數(shù)據(jù)。

示例 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)證

對(duì)于持續(xù)集成、自動(dòng)化測(cè)試或生產(chǎn)環(huán)境，您可能希望使用構(gòu)建工具或 CI 管道（如 GitHub Actions、Jenkins 等）自動(dòng)進(jìn)行 JSON 驗(yàn)證。

• 您可以使用 JSONLint、prettier 等工具，或使用編程語言編寫自定義驗(yàn)證腳本并將其集成到您的工作流程中。

結(jié)論

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

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

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