JSON إلى CSV
حوّل مصفوفة كائنات JSON إلى جدول CSV جاهز لـ Excel أو Google Sheets. تُكتشف الأعمدة تلقائياً من المفاتيح وتبقى القيم المتداخلة كنص JSON.
حوّل مصفوفة من كائنات JSON إلى جدول CSV يفتحه Excel وGoogle Sheets وNumbers وLibreOffice بالأعمدة مفصولة سلفاً. وتأتي أسماء الأعمدة من مفاتيح الكائنات، ويُستخدم اتحاد كل المفاتيح، فتصطف الصفوف التي تنقصها بعض الحقول في مكانها الصحيح.
وهذه هي الخطوة القياسية عندما يعيد API بيانات تريد ترتيبها أو تصفيتها أو رسمها بيانياً: اجلب JSON، والصقه هنا، فيكون الجدول جاهزاً. أما القيم التي هي نفسها كائنات أو مصفوفات فتبقى كنص JSON داخل الخلية، فلا تُفقد أي بيانات بصمت.
كيفية تحويل JSON إلى CSV
الصق مصفوفة JSON من كائنات
راجع الأعمدة المكتشفة
انسخ CSV أو نزّله
الأسئلة الشائعة
ما شكل JSON المتوقع؟
مصفوفة من كائنات، مثل [{"name":"Ana","age":31}, ...]. ويُعامل الكائن الواحد كصف واحد؛ أما البنى المتداخلة بعمق فتُسطَّح إلى نص JSON داخل الخلية.
كيف تُختار أسماء الأعمدة؟
من مفاتيح الكائنات. وكل مفتاح يظهر في أي موضع من المصفوفة يصبح عموداً، وتُترك القيم المفقودة فارغة.
هل الفواصل وعلامات التنصيص في بياناتي آمنة؟
نعم، تُوضع القيم التي تضم فواصل أو علامات تنصيص أو فواصل أسطر بين علامات تنصيص وتُهرَّب وفق معيار CSV، فيُفتح الملف بعدد الأعمدة الصحيح.
لماذا يعرض Excel كل شيء في عمود واحد؟
قد يخمّن Excel الفاصل الخطأ عند فتح ملف .csv مباشرةً. استخدم Data > From Text/CSV واختر الفاصلة، أو احفظ الملف بصيغة .xlsx بدلاً من ذلك.
ماذا يحدث للكائنات المتداخلة؟
تُكتب كنص JSON داخل الخلية بدلاً من توسيعها إلى أعمدة، فتبقى البنية الأصلية محفوظة ويمكن تحليلها مرة أخرى لاحقاً.
هل تُرفع بياناتي؟
لا، يجري التحويل في متصفحك؛ وهذا مهم عندما يضم JSON سجلات عملاء.
نظرة سريعة
| المدخل | JSON |
|---|---|
| عدة ملفات | لا |
| مكان التشغيل | في متصفحك، ولا تُرفع الملفات أبداً |
| يعمل دون اتصال | نعم — بعد تحميل الصفحة |
| السعر | مجاني، بلا تسجيل وبلا علامة مائية |
اختيار صيغة البيانات
JSON هو الصيغة الافتراضية لكل ما تُرجعه واجهة API أو يقرأه برنامج: فهو يتعامل بطبيعته مع البنى المتداخلة والأرقام والقيم المنطقية وnull، وكل لغة تحلّله. أما CSV فأصغر حجماً ويُفتح مباشرة في جدول بيانات، لكنه لا يملك وسيلة للتعبير عن التداخل ولا معياراً مشتركاً للفاصل أو التنصيص أو مجموعة المحارف، وهذا بالضبط موضع الخطأ في التحويلات. أما XML فمطوّل لكنه يحمل السمات والمحتوى المختلط والمخططات، ولذلك ما زال مهيمناً على صيغ المستندات والتكاملات القديمة. وYAML هو الأسهل قراءةً في الإعدادات لكنه حساس للمسافات البيضاء وفيه إكراه مفاجئ للأنواع («no» تصبح false، وإصدار مثل 1.10 يصبح 1.1). فاختر الصيغة التي تفضّلها الأداة المستهلكة لا الصيغة الأجمل منظراً.
أين تنكسر التحويلات بهدوء
معظم أخطاء التحويل لا تتعلق بالصياغة بل بالمعنى. فعمود من الرموز البريدية في ملف CSV يفقد أصفاره البادئة في اللحظة التي يخمّن فيها جدول البيانات أنه رقم؛ ومعرّف طويل يتجاوز دقة الفاصلة العائمة؛ والتواريخ يتغير معناها بحسب ما إذا كان اليوم أولاً أم الشهر أولاً. ومفاتيح JSON غير مرتبة أما المصفوفات فمرتبة، والأداة التي ترتب المفاتيح لا تغيّر شيئاً بينما التي ترتب المصفوفات تغيّر البيانات. وUnicode فخ آخر: فقد يصل النص بترميز UTF-8 أو UTF-16 أو مع علامة ترتيب البايتات، وفاكّ الترميز الذي يخمّن خطأً يحوّل المحارف المشكّلة إلى نص مشوّه. وقبل أن تثق بأي تحويل، افحص الصف الأول والأخير، وكل حقل فيه أصفار بادئة، وكل حقل يحتوي على علامات تنصيص أو فواصل أو أسطر جديدة.