تنسيق JSON والمسافات البادئة: Tabs أم Spaces

المسافات في مواصفة JSON

المسافات والأسطر الجديدة لا تغيّر المعنى لدى المحلل؛ القرار هنا يخص القراءة والتوحيد داخل الفريق.

يفضل معظم الفرق spaces لأنها أكثر ثباتًا بين المحررات وتعطي فروق Git أوضح. tabs قانونية لكن نادرة في أمثلة JSON العامة.

مسافتان شائعتان في بيئات الويب وNode، وأربع مسافات تظهر أحيانًا في بيئات Java/Python. الأهم اختيار معيار واحد لكل مستودع.

{
  "user": {
    "name": "Alice",
    "roles": ["admin", "editor"]
  }
}

عند التصحيح والتوثيق والتحرير اليدوي. التنسيق قبل المراجعة يجعل diff يعرض التغييرات الحقيقية فقط.

للنقل في الإنتاج وتقليل الحجم. احتفظ بنسخة مقروءة في مكان آخر ولا تعدل JSON المصغر يدويًا.

استخدم .editorconfig لملفات JSON، ويمكن إضافة فحص parse في CI، وتوحيد أمثلة الوثائق على مسافتين.