كيفية إنشاء ملف .JSON في برنامج المفكرة (Notepad)

JSON هو نص عادي ذو قواعد صارمة. يمكن لبرنامج المفكرة كتابته بشكل جيد. الجزء الذي يخطئ فيه الناس هو بناء الجملة وليس الأداة. اجعل الهيكل صحيحاً، وحفظ الملف هو الجزء الأسهل.

ما هو ملف JSON؟

تختصر كلمة JSON لـ JavaScript Object Notation. وهي تخزن البيانات كأزواج من المفتاح والقيمة داخل أقواس متعرجة، مع دعم الكائنات المتداخلة والمصفوفات. تستخدمها التطبيقات، وواجهات برمجة التطبيقات (APIs)، وملفات التكوين لأنها خفيفة الوزن وكل لغة برمجة رئيسية يمكنها قراءتها.

يبدو ملف JSON الأساسي كالتالي:

{

  "name": "John",

  "age": 28,

  "isActive": true,

  "skills": ["writing", "editing"]

}

خطوة بخطوة: إنشاء ملف JSON في برنامج المفكرة

الخطوة 1: افتح برنامج المفكرة (Notepad)

افتَح برنامج المفكرة على حاسوبك، أو استخدم مفكرة مجانية عبر الإنترنت من أي متصفح.

الخطوة 2: ابدأ بقوس فتح

يبدأ كل ملف JSON بـ { للكائن أو [ للمصفوفة. يبدأ معظم الملفات بكائن.

الخطوة 3: أضف مفاتيحك وقيمك

اكتب كل مفتاح بين علامتي اقتباس مزدوجتين، يليه نقطتان رأسيتان، ثم القيمة. افصل بين كل زوج بفصلة (فارزة).

{

  "title": "Sample File",

  "version": 1

}

الخطوة 4: اغلق الملف بشكل صحيح

طابق كل قوس فتح أو قوس مربع بقوس إغلاق. زوج المفتاح والقيمة الأخير في الكائن أو المصفوفة لا يحتاج إلى فصلة في نهايته.

الخطوة 5: احفظ الملف بامتداد .json

اذهب إلى ملف (File)، ثم حفظ باسم (Save As). اختر "كل الملفات" (All Files) من قائمة "حفظ كنوع" (Save as type) المنسدلة. سمِّ الملف بامتداد .json، على سبيل المثال data.json. الحفظ دون تغيير هذه القائمة المنسدلة سيتركك مع ملف .txt لن يتم قراءته كملف JSON.

الخطوة 6: تحقق من صحة الملف قبل استخدامه

قم لصق الملف في محرر JSON للتأكد من أنه صالح قبل استخدامه في برنامج نصي أو تطبيق. الفحص السريع هنا يوفر عليك عناء تصحيح الأخطاء لاحقاً.

قواعد بناء جملة JSON التي يجب تذكرها

• علامات اقتباس مزدوجة فقط. تحتاج المفاتيح وقيم النصوص إلى علامات اقتباس مزدوجة وليس مفردة.

• بدون فصلة زائدة في النهاية. لا يوجد شيء يتبع العنصر الأخير في الكائن أو المصفوفة.

• بدون تعليقات. لا يدعم JSON القياسي ملاحظات التعليق مثل // أو /* */ داخل الملف.

• القيم البوليانية بأحرف صغيرة (lowercase). استخدم true و false، وليس True أو FALSE.

• الأرقام لا تحتاج إلى علامات اقتباس. اكتب 28، وليس "28"، إلا إذا كانت القيمة مقصودة كنص.

الأخطاء الشائعة وكيفية تجنبها

المشكلة: فصلة مفقودة بين أزواج المفتاح والقيمة. الحل: كل زوج باستثناء الأخير يحتاج إلى فصلة بعده.

المشكلة: أقواس غير متطابقة. الحل: عدّ أقواس {} و [] الخاصة بك. سيوجهك المدقق إلى السطر الدقيق الذي لا تتطابق فيه.

المشكلة: اقتباسات غير مسربة داخل نص. الحل: قم بهروب (Escape) الاقتباسات الداخلية بشرطة مائلة عكسية، على سبيل المثال \"He said \\\"hello\\\"".

المشكلة: مفتاح بدون علامات اقتباس. الحل: يجب أن يتم لف كل مفتاح بعلامات اقتباس مزدوجة، حتى البسيطة منها مثل id أو name.

الخاتمة

ملف JSON هو مجرد نص يتبع تنسيقاً صارماً. اكتب مفاتيحك وقيمك علامات اقتباس مزدوجة، وطابق أقواسك، وتخطي الفصلة الأخيرة، واحفظه بامتداد .json. شغله عبر أداة التحقق مرة واحدة قبل استخدامه، وستكون جاهزاً.