تخطي إلى المحتوى
SPCXTools

محول JSON إلى CSV

حوّل مصفوفات JSON إلى ملفات CSV جاهزة لجداول البيانات، مع تسطيح الكائنات المتداخلة إلى أعمدة.

تعمل محلياً — ملفاتك لا تغادر جهازك أبداً

جاري تحميل الأداة…

كيفية استخدام محول JSON إلى CSV

  1. 1الصق كود JSON في المربع الأيسر، أو اضغط على فتح ملف لتحميل ملف .json.
  2. 2اختر الفاصل — الفاصلة لمعظم الأدوات، أو الفاصلة المنقوطة لبرنامج Excel في العديد من المناطق الأوروبية، أو مسافة الجدولة (Tab) لملفات TSV.
  3. 3حدد ما إذا كنت تريد تضمين صف الرأس وتسطيح الكائنات المتداخلة إلى أعمدة مفصولة بنقاط.
  4. 4انسخ ملف CSV أو قم بتنزيله. حدد خيار UTF-8 متوافق مع Excel إذا كانت الأحرف تظهر بشكل غير صحيح في Excel.

تحويل JSON إلى CSV لجداول البيانات

تتعامل واجهات برمجة التطبيقات (APIs) وقواعد البيانات وأدوات التسجيل بتنسيق JSON، لكن الزملاء والعملاء والمحللين غالباً ما يفضلون جداول البيانات. تقوم أداة تحويل JSON إلى CSV هذه بتحويل مصفوفة JSON إلى ملف CSV يمكنك فتحه في Excel أو Google Sheets أو Numbers أو أي أداة بيانات أخرى. يتم تسطيح الكائنات المتداخلة لتصبح أعمدة مستقلة، وتُعالج الحقول المفقودة بمرونة، وتُعالج الرموز الخاصة بشكل صحيح. تتم عملية التحويل داخل متصفحك، مما يضمن بقاء بياناتك خاصة.

الميزات

  • مصفوفات الكائنات، أو مصفوفات المصفوفات، أو كائن واحد كمدخلات.
  • تسطيح الكائنات المتداخلة إلى أعمدة مثل address.city و address.country.
  • تتحول جميع المفاتيح إلى أعمدة — تُدمج الكائنات ذات الحقول المختلفة في جدول واحد متناسق.
  • اختيار الفاصل: فاصلة، فاصلة منقوطة، مسافة جدولة (TSV)، أو خط عمودي (pipe).
  • معالجة صحيحة (Escaping) للفواصل وعلامات الاقتباس وفواصل الأسطر وفقاً لمعايير CSV.
  • خيار UTF-8 متوافق مع Excel يضيف علامة ترتيب البايت (BOM) لضمان عرض الحركات والنصوص غير اللاتينية بشكل صحيح.
  • النسخ أو التنزيل، مع الاحتفاظ باسم الملف الأصلي عند فتح ملف.

مثال

هذا الـ JSON:

[
  { "id": 1, "name": "Ada", "address": { "city": "London" }, "tags": ["math"] },
  { "id": 2, "name": "Alan", "address": { "city": "Manchester" } }
]

يصبح ملف الـ CSV هذا:

id,name,address.city,tags
1,Ada,London,"[""math""]"
2,Alan,Manchester,

تُخزن مصفوفة tags كنص JSON في خلية واحدة، مع مضاعفة علامات الاقتباس الخاصة بها كما يتطلب تنسيق CSV. لا يحتوي الصف الثاني على أي علامات (tags)، لذا تكون الخلية فارغة.

نصائح

  • استخرج المصفوفة أولاً. تضع العديد من استجابات API القائمة داخل كائن، مثل {"data": [...], "page": 1}. تحويل الكائن بالكامل ينتج عنه صف واحد؛ لذا انسخ المصفوفة فقط للحصول على صف لكل عنصر.
  • اختر الفاصلة المنقوطة لـ Excel في أوروبا. إذا وضع Excel كل البيانات في عمود واحد، فهذا يعني أن نظامك يستخدم الفاصلة كفاصل عشري. استخدم الفاصلة المنقوطة كفاصل، أو استورد الملف في Excel عبر بيانات › من نص/CSV (Data › From Text/CSV).
  • تحقق من صحة البيانات أولاً. إذا كان كود JSON يحتوي على خطأ في الصيغة، فستوضح لك الرسالة مكانه. يمكن أن تساعدك أداة منسق JSON في العثور عليه وإصلاحه.

أدوات ذات صلة

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

الأسئلة الشائعة

ما هي هياكل JSON التي يمكن تحويلها؟
أفضل إدخال هو مصفوفة كائنات، مثل استجابة API: [{"id": 1, "name": "Ada"}, …]. يصبح كل كائن صفاً وكل مفتاح عموداً. يتم تحويل مصفوفة المصفوفات صفاً بصف، ويصبح الكائن المفرد جدولاً من صف واحد.
كيف يتم التعامل مع الكائنات والمصفوفات المتداخلة؟
عند تحديد Flatten nested objects، تصبح الكائنات المتداخلة أعمدة منفصلة بأسماء مفصولة بنقطة، لذا {"address": {"city": "London"}} يصبح عموداً باسم address.city. تُكتب المصفوفات في خلية واحدة كنص JSON (["a","b"])، لأن طولها غير محدد. بدون التسطيح، تُكتب الكائنات المتداخلة أيضاً كنص JSON.
ماذا يحدث إذا كانت الكائنات تحتوي على مفاتيح مختلفة؟
يجمع المحول كل مفتاح يظهر في أي كائن ويستخدمها جميعاً كأعمدة، بنفس ترتيب ظهورها الأول. أما الصفوف التي لا تحتوي على مفتاح معين فتُترك خليتها فارغة.
لماذا تظهر الحروف غير اللاتينية أو المشكّلة بشكل غير صحيح في Excel؟
تفترض بعض إصدارات Excel ترميزاً إقليمياً قديماً عند فتح ملفات CSV. حدد Excel-friendly UTF-8 لإضافة علامة ترتيب البايت (BOM) إلى الملف المُنزّل، مما يخبر Excel أن الملف بترميز UTF-8. يتعامل Google Sheets و Numbers مع UTF-8 بدونها.
هل هناك حد لحجم الملف؟
لا يوجد حد ثابت. تُحوّل الملفات بحجم عدة ميغابايت في لحظات. أما الملفات الكبيرة جداً فيقتصر حجمها على ذاكرة جهازك فقط، حيث تتم معالجة كل شيء محلياً داخل المتصفح.
هل تُرسل بيانات JSON الخاصة بي إلى خادم؟
لا. تتم عمليات التحليل والتحويل على جهازك، لذا تظل استجابات API والسجلات والملفات المُصدَّرة خاصة.