## 注釋
**JSON對象中不包含注釋。**
JSON對象中不應該包含注釋。該指南中的某些示例含有注釋。但這僅僅是為了說明示例。
~~~
{
// 你可能在下面的示例中看到注釋,
// 但不要在你的JSON數據中加入注釋.
"propertyName": "propertyValue"
}
~~~
## 雙引號
**使用雙引號**
如果(某個)屬性需要引號,則必須使用雙引號。所有的屬性名必須在雙引號內。字符類型的屬性值必須使用雙引號。其它類型值(如布爾或數字)不應該使用雙引號。
## 扁平化數據 VS 結構層次
**不能為了方便而將數據任意分組**
JSON中的數據元素應以_扁平化_方式呈現。不能為了方便而將數據任意分組。
在某些情況下,比如描述單一結構的一批屬性,因為它被用來保持結構層次,因而是有意義的。但是遇到這些情況還是應當慎重考慮,記住只有語義上有意義的時候才使用它。例如,一個地址可以有表示兩種方式,但結構化的方式對開發人員來講可能更有意義:
扁平化地址:
~~~
{
"company": "Google",
"website": "http://www.google.com/",
"addressLine1": "111 8th Ave",
"addressLine2": "4th Floor",
"state": "NY",
"city": "New York",
"zip": "10011"
}
~~~
結構化地址:
~~~
{
"company": "Google",
"website": "http://www.google.com/",
"address": {
"line1": "111 8th Ave",
"line2": "4th Floor",
"state": "NY",
"city": "New York",
"zip": "10011"
}
}
~~~
- Google 開源項目風格指南 (中文版)
- C++ 風格指南
- 0. 扉頁
- 1. 頭文件
- 2. 作用域
- 3. 類
- 4. 來自 Google 的奇技
- 5. 其他 C++ 特性
- 6. 命名約定
- 7. 注釋
- 8. 格式
- 9. 規則特例
- 10. 結束語
- Objective-C 風格指南
- Google Objective-C Style Guide 中文版
- 留白和格式
- 命名
- 注釋
- Cocoa 和 Objective-C 特性
- Cocoa 模式
- Python 風格指南
- Google Python 風格指南 - 中文版
- 背景
- Python語言規范
- Python風格規范
- 臨別贈言
- JSON 風格指南
- 簡介
- 定義
- 一般準則
- 屬性名準則
- 屬性值準則
- 屬性值數據類型
- JSON結構和保留屬性名
- 頂級保留屬性名稱
- data對象的保留屬性名
- 用于分頁的保留屬性名
- 用于鏈接的保留屬性名
- 錯誤對象中的保留屬性名
- 屬性順序
- 示例
- 附錄