Menu
flag Ar iconالعربيةdown icon

محوّل JSON إلى CSV

حوّل مصفوفات JSON إلى CSV والعكس، مع صف عناوين.

بقلم Nethanel Bar, Co-founder & CEO

آخر تحديث

هل أنت مستعد لتعلّم البرمجة فعلاً؟

يعلّمك Coddy عبر كتابة كود حقيقي في متصفحك: دروس تفاعلية، وملاحظات فورية، ومساعدة بالذكاء الاصطناعي عندما تتعثر.

ما هو محول JSON إلى CSV؟

محول JSON إلى CSV يحوّل بيانات JSON المهيكلة - عادةً مصفوفة كائنات مثل استجابة API - إلى جدول مسطّح مفصول بفواصل يمكنك فتحه في Excel أو Google Sheets أو استيراده إلى قاعدة بيانات. ويعمل في الاتجاه المعاكس أيضًا: يحلل ملف CSV (مع صف عناوين) ويعيده إلى مصفوفة كائنات JSON.

عند التحويل JSON → CSV، تجمع الأداة كل المفاتيح من جميع الكائنات لبناء صف العناوين، ثم تكتب صفًا واحدًا لكل كائن. القيم التي تحتوي على فواصل أو علامات اقتباس أو أسطر جديدة تُحاط بعلامات اقتباس وفق معيار CSV، لذا يُفتح الناتج بشكل سليم في أي جدول بيانات. وعند التحويل CSV → JSON، يُعامل الصف الأول كأسماء الأعمدة ويصبح كل صف تالٍ كائنًا؛ وتُميَّز الأرقام والقيم المنطقية تلقائيًا.

كل شيء يعمل محليًا في متصفحك - بياناتك لا تُرفع أبدًا.

ما ستتعلمه أثناء التحويل

  • CSV تنسيق مسطّح ثنائي الأبعاد، بينما يمكن لـ JSON أن يتداخل - القيم المتداخلة بعمق تُحوَّل إلى نص داخل خلية CSV واحدة.
  • معيار CSV (RFC 4180) يحيط أي حقل يحتوي على فاصلة أو علامة اقتباس مزدوجة أو سطر جديد بعلامات اقتباس، ويضاعف علامات الاقتباس الداخلية.
  • يحتاج CSV إلى صف عناوين حتى يُربط كل عمود بمفتاح JSON عند التحويل العكسي.
  • يعمل JSON → CSV بأفضل شكل مع مصفوفة كائنات مسطّحة لها البنية نفسها ('جدول' من السجلات).

كيفية تحويل JSON إلى CSV خطوة بخطوة

  1. اختر الاتجاه

    اختر JSON → CSV لتسطيح JSON إلى جدول، أو CSV → JSON للاتجاه المعاكس.

  2. الصق بياناتك

    لتحويل JSON → CSV، الصق مصفوفة كائنات. ولتحويل CSV → JSON، الصق CSV صفه الأول هو صف العناوين.

  3. تحقق من الأعمدة

    تُكتشف الأعمدة تلقائيًا من مفاتيح الكائنات (JSON → CSV) أو من صف العناوين (CSV → JSON).

  4. انسخ أو بدّل

    انسخ النتيجة بنقرة واحدة، أو اضغط تبديل لتحويلها مباشرة في الاتجاه الآخر.

أمثلة لتجربتها

قائمة سجلات

Paste a small example into the tool and change one part at a time.

تصبح ملف CSV بعنوان id,name وصف واحد لكل كائن.

قيم تحتاج إلى علامات اقتباس

Copy the original value, run the tool, then compare the result.

الفاصلة داخل القيمة تُحفظ بإحاطة الخلية بعلامات اقتباس: "hello, world".

أخطاء شائعة

  • تمرير كائن JSON واحد بدلًا من مصفوفة - JSON → CSV يتوقع مصفوفة كائنات (قائمة صفوف).
  • CSV بدون صف عناوين - يُستخدم الصف الأول كأسماء للأعمدة، فإذا غاب تنزاح بياناتك.
  • توقّع أن تتوسع الكائنات المتداخلة إلى أعمدة - القيم العميقة تُحوَّل إلى نص في خلية واحدة ولا تُسطَّح تلقائيًا.

الأسئلة الشائعة حول تحويل JSON إلى CSV

كيف أحوّل JSON إلى CSV؟
الصق مصفوفة كائنات JSON في وضع JSON → CSV. تبني الأداة صف العناوين من المفاتيح وتكتب صف CSV لكل كائن، مع إحاطة القيم بعلامات اقتباس عند الحاجة.
هل يمكنني إعادة تحويل CSV إلى JSON؟
نعم. انتقل إلى وضع CSV → JSON والصق CSV مع صف عناوين؛ يصبح كل صف كائن JSON مفاتيحه هي أسماء الأعمدة.
هل تتعامل الأداة مع الفواصل وعلامات الاقتباس داخل القيم؟
نعم. يتبع الناتج معيار CSV - الحقول التي تحتوي على فواصل أو علامات اقتباس أو أسطر جديدة تُحاط بعلامات اقتباس مزدوجة، وتُضاعف علامات الاقتباس الداخلية.
هل تُرفع بياناتي إلى أي مكان؟
لا. يتم التحليل والتحويل بالكامل في متصفحك، فلا يُرسل أي شيء إلى الخادم.

اعرف المزيد

أدوات مطورين أخرى

Coddy programming languages illustration

تعلّم البرمجة مع Coddy

ابدأ الآن