كيف تفتح ملف JSON
كل طرق فتح ملف json وقراءته، من الأسرع إلى الأقوى، وكيف تصلح ملفًا لا يُفتح.
بقلم Shahzad Ali ·
ما هو ملف JSON
JSON نص عادي يخزّن البيانات في كائنات من أزواج "مفتاح": قيمة، وفي قوائم بين أقواس مربعة. تستخدمه واجهات API وملفات الإعدادات وتصدير البيانات. كل برنامج يفتح النصوص يفتح ملف json؛ الصعوبة في قراءته حين يكون سطرًا واحدًا طويلًا أو متداخلًا على مستويات كثيرة.
الطريقة الأسرع: افتحه في متصفحك
أفلت الملف على عارض JSON، أو الصق JSON بضغط Ctrl+V (أو Cmd+V على ماك). يعرض شجرة قابلة للطي، وجدولًا حين يكون الملف قائمة كائنات، والنص بأرقام الأسطر. لا يُرفع شيء، ويعمل على الهاتف أيضًا: اضغط «اختر ملفًا» وحدد ملف json من «الملفات» أو مجلد التنزيلات. تُفتح الملفات حتى 10 ميغابايت.
على ويندوز أو ماك دون برامج إضافية
كل متصفح يفتح JSON: اسحب الملف إلى نافذة Chrome أو Edge أو Firefox. يعرض Firefox عارضًا مدمجًا بشجرة قابلة للطي، وتعرض المتصفحات الأخرى النص. ويفتحه «المفكرة» على ويندوز وTextEdit على ماك نصًا أيضًا: اضغط بزر الفأرة الأيمن على الملف، واختر «فتح باستخدام»، ثم المحرر. يكفيان للملفات الصغيرة، لكن الأسطر الطويلة والتداخل العميق يصعب تتبعهما.
في محرر شيفرة
إن كنت تتعامل مع JSON كثيرًا، فمحرر شيفرة مثل Visual Studio Code المجاني يلوّن الصياغة ويطوي الكائنات ويُعلّم الأخطاء. ويرتّب أمر Format Document (Shift+Alt+F على ويندوز، وShift+Option+F على ماك) ملفًا محفوظًا في سطر واحد.
اجعل الملف المحفوظ في سطر واحد مقروءًا
الملف المحفوظ في سطر واحد صالح لكنه غير مقروء. يضيف منسّق JSON المسافات البادئة بمسافتين أو أربع (أي عدد من 1 إلى 8، أو علامة جدولة)، ويرتّب المفاتيح، ويضغط الملف من جديد حين تحتاج ملفًا صغيرًا.
إن لم يُفتح الملف
الرسالة تقول السبب في الغالب:
- "Unexpected token" أو "Unexpected end of JSON input" تعني أن النص يخالف قاعدة من قواعد JSON: فاصلة زائدة، أو علامات اقتباس مفردة، أو تعليق. يعرض مدقق JSON السطر والعمود ويصلح الأخطاء الشائعة، ويشرح دليل أخطاء unexpected token كل رسالة.
- الملف الذي يبدأ بالعلامة < صفحة HTML حُفظت باسم json، وغالبًا صفحة خطأ من خادم.
- الملف الذي فيه كائن JSON في كل سطر (jsonl أو ndjson) هو JSON Lines: كل سطر مستند مستقل، فيرفض محلل JSON العادي الملف كله، ولا يفتحه OpenAnyDoc بعد.
- فوق 10 ميغابايت يرفض OpenAnyDoc الملف كي تبقى الصفحة سريعة الاستجابة؛ ويتعامل محرر شيفرة أو أداة سطر أوامر مثل jq مع الملفات الأكبر.
حوّل JSON إلى جدول
إن كان الملف قائمة سجلات، فإن محوّل JSON إلى CSV يسطّح الحقول المتداخلة في أعمدة (تصبح عناوينها مثل address.city)، ويفتح النتيجة جدولًا يمكنك تنزيله وفتحه في Excel.
أسئلة؟
راسلنا على support@openanydoc.com واذكر ما يظهر حين تفتح الملف (دون بيانات شخصية).