دليل خطوة بخطوة
كيف تصلح أخطاء صياغة JSON الشائعة
تاريخ التحديث: 9 أكتوبر 2026
صيغة JSON صارمة: المفاتيح والنصوص بين علامات اقتباس مزدوجة، والعناصر تفصلها فواصل دون فاصلة بعد آخرها، ولا تُقبل التعليقات. الصق JSON في منسّق JSON ومدقّقه من FileICU: يذكر المشكلة ويميّز السطر، فتصلحه وتتحقق مرة أخرى.

كيف تفعل ذلك باستخدام منسّق JSON ومدقّقه
- افتح منسّق JSON ومدقّقه والصق JSON.
- إذا كان صالحًا فإنه يُنسَّق بالمسافة البادئة التي تختارها: مسافتان أو أربع مسافات أو علامات جدولة.
- وإن لم يكن صالحًا، فاقرأ رسالة الخطأ وانظر إلى السطر المميَّز.
- أصلح الخطأ مستعينًا بالأمثلة أدناه، وتتحدث النتيجة أثناء الكتابة.
- انسخ JSON المنسَّق عندما يصبح صالحًا.
الفواصل الزائدة
الفاصلة بعد العنصر الأخير هي أكثر الأخطاء شيوعًا، وغالبًا ما تبقى بعد حذف سطر. احذفها.
غير صالح:
{ "name": "Ana", "age": 31, }
صالح:
{ "name": "Ana", "age": 31 }علامات الاقتباس المفردة والمفاتيح دون اقتباس
تقبل JavaScript كليهما، أما JSON فلا تقبل أيًّا منهما. كل مفتاح وكل قيمة نصية تحتاج إلى علامات اقتباس مزدوجة. وتُكتب الأرقام وtrue وfalse وnull دون علامات اقتباس.
غير صالح:
{ name: 'Ana', active: 'true' }
صالح:
{ "name": "Ana", "active": true }التعليقات والفواصل والأقواس الناقصة
لا تعليقات في JSON، فاحذف أي سطر فيه // أو /* */. والفاصلة الناقصة بين عنصرين، أو القوس الذي يُفتح ولا يُغلق، يجعل الخطأ يظهر في السطر التالي للخطأ الحقيقي، فانظر أيضًا إلى السطر الذي فوق السطر المميَّز.
غير صالح:
[
{ "id": 1 }
{ "id": 2 }
صالح:
[
{ "id": 1 },
{ "id": 2 }
]نص يحتاج إلى تهريب
داخل القيمة النصية تُكتب علامة الاقتباس المزدوجة \" والشرطة المائلة العكسية \\. ويُكتب فاصل السطر داخل القيمة \n لا كسطر جديد حقيقي. ومسارات Windows فخ شائع: يجب كتابة C:\Users على شكل C:\\Users.
مشكلات شائعة
- يشير الخطأ إلى سطر يبدو صحيحًا.
- الخطأ الحقيقي غالبًا قبله مباشرة، مثل فاصلة ناقصة أو علامة اقتباس غير مغلقة في السطر السابق.
- JSON مأخوذ من موقع أو سجل وحوله نص إضافي.
- انسخ فقط الجزء من أول { أو [ حتى القوس المغلق المقابل له.
- هل تستطيع الأداة إصلاح الأخطاء نيابة عني؟
- لا. تُظهر ما الخطأ، لكنها لا تخمّن ما قصدته، لأن التخمين الخاطئ قد يغيّر بياناتك.
أدوات لهذه المهمة
- المطورونتنسيق
منسّق JSON ومدقّقه
تحقّق من صحة صياغة JSON ونسّق البيانات الصالحة بمسافات بادئة مقروءة.
- المطورونتحويل
JSON إلى CSV
حوّل مصفوفات سجلات JSON إلى صفوف CSV مفصولة.
- المطورونتحويل
YAML إلى JSON
حلّل مستند YAML وحوّل قيمه إلى JSON منسّق محليًا.
- المطورونتحويل
CSV إلى JSON
حلّل صفوف CSV، بما فيها القيم بين علامات الاقتباس، وحوّلها إلى سجلات JSON.