一般準(zhǔn)則

注釋

JSON對(duì)象中不包含注釋。

JSON對(duì)象中不應(yīng)該包含注釋。該指南中的某些示例含有注釋。但這僅僅是為了說(shuō)明示例。

{
  // 你可能在下面的示例中看到注釋,
  // 但不要在你的JSON數(shù)據(jù)中加入注釋.
  "propertyName": "propertyValue"
}

雙引號(hào)

使用雙引號(hào)

如果（某個(gè)）屬性需要引號(hào)，則必須使用雙引號(hào)。所有的屬性名必須在雙引號(hào)內(nèi)。字符類型的屬性值必須使用雙引號(hào)。其它類型值（如布爾或數(shù)字）不應(yīng)該使用雙引號(hào)。

扁平化數(shù)據(jù) VS 結(jié)構(gòu)層次

不能為了方便而將數(shù)據(jù)任意分組

JSON中的數(shù)據(jù)元素應(yīng)以_扁平化_方式呈現(xiàn)。不能為了方便而將數(shù)據(jù)任意分組。

在某些情況下，比如描述單一結(jié)構(gòu)的一批屬性，因?yàn)樗挥脕?lái)保持結(jié)構(gòu)層次，因而是有意義的。但是遇到這些情況還是應(yīng)當(dāng)慎重考慮，記住只有語(yǔ)義上有意義的時(shí)候才使用它。例如，一個(gè)地址可以有表示兩種方式，但結(jié)構(gòu)化的方式對(duì)開(kāi)發(fā)人員來(lái)講可能更有意義：

扁平化地址:

{
  "company": "Google",
  "website": "http://www.google.com/",
  "addressLine1": "111 8th Ave",
  "addressLine2": "4th Floor",
  "state": "NY",
  "city": "New York",
  "zip": "10011"
}

結(jié)構(gòu)化地址：

{
  "company": "Google",
  "website": "http://www.google.com/",
  "address": {
    "line1": "111 8th Ave",
    "line2": "4th Floor",
    "state": "NY",
    "city": "New York",
    "zip": "10011"
  }
}