تحويل JSON إلى CSV
حوّل ملفات JSON وبياناته إلى صيغة CSV فورًا بهذا المحوّل المجاني الذي يعمل في المتصفح. آمن وسريع ويعمل مباشرة داخل متصفحك.
واجهة الأداة نفسها باللغة الإنجليزية حاليًا، وتعمل بالكامل داخل متصفحك.
جارٍ تحميل الأداة…
تحويل JSON المتداخل إلى جدول مسطح
JSON شجرة: الكائنات قد تحتوي كائنات، قد تحتوي مصفوفات من كائنات أخرى، إلى أي عمق. أما CSV فشبكة: صفوف وأعمدة، لا تداخل فيها. والتحويل بينهما يعني التسطيح، والتسطيح ينطوي دائمًا على خيارات حول كيف تصبح الشجرة جدولًا.
والطريقة المعتادة أن يُعامل كل عنصر في المصفوفة العليا كصف، وكل قيمة طرفية كعمود، مع ضم المفاتيح المتداخلة في مسارات بنقاط، فيصبح user.address.city اسم عمود واحد. والمصفوفات داخل سجل تصبح إما أعمدة مرقمة أو نصًا مضمومًا. والحقول الغائبة عن بعض السجلات تترك خلايا فارغة. وفهم هذا هو ما يمنع الناتج من مفاجأتك: فحمولة متداخلة بعمق قد تنتج أعمدة أكثر بكثير مما توقعت، والسجلات غير المنتظمة تنتج شبكة متناثرة.
لماذا أنشأنا هذه الأداة
السبب واحد دائمًا تقريبًا: أحدهم يحتاج البيانات في جدول بيانات. واجهة API تعيد JSON، لكن فريق المالية يعمل في Excel، والمحلل يريد جدولًا محوريًا، أو نظام لا يستورد إلا CSV.
وتلك البيانات المصدّرة عادةً سجلات عملاء أو طلبات أو استخدام، وهي بالضبط المواد التي لا ينبغي لصقها في محوّل مجهول. بنينا هذه الأداة لتعمل في المتصفح فيكون التحويل حسابًا محليًا: يُحلل JSON ويُسطّح ويُعاد كتابته كـ CSV على جهازك، ثم يُنزّل. لا رفع، ولا حد للصفوف، ولا حساب. ولمن يتعامل مع بيانات شخصية تحكمها قوانين حماية البيانات، هذا الفرق ليس تفضيلًا؛ إنه الفرق بين عملية محلية ونقل إلى طرف ثالث.
نصائح وأخطاء شائعة
- الحمولات المتداخلة بعمق تنتج جداول عريضة جدًا؛ سطّح الفرع الذي تحتاجه فقط بدل المستند كله.
- استخدم الفاصلة المنقوطة فاصلًا إذا كان الجدول سيُفتح في إعدادات إقليمية تستخدم الفاصلة فاصلًا عشريًا.
- إذا ظهر النص العربي رموزًا غريبة عند فتح الملف بنقرة مزدوجة في Excel، فاستورده عبر «البيانات ← من نص/CSV» واختر ترميز UTF-8، أو افتحه في Google Sheets.
- المعرّفات الرقمية الطويلة قد تشوهها جداول البيانات إلى صيغة علمية؛ استوردها كنص.
بداية سريعة: استخدام تحويل JSON إلى CSV
- الصق JSON الذي تريد تحويله أو حمّله، وهو عادةً مصفوفة من الكائنات.
- تحقق من الأعمدة المكتشفة واضبط الفاصل إذا كان جدولك يتوقع فواصل منقوطة.
- شغّل التحويل وراجع الصفوف الأولى في المعاينة.
- تأكد أن الحقول المتداخلة سُطّحت كما توقعت.
- نزّل ملف CSV وافتحه في برنامج جداول البيانات.
رحلة العودة هي تحويل CSV إلى JSON. وإذا لم يُحلل المصدر، فافحصه بأداة مدقق JSON أولًا.
كيف يتحول الملف
تصبح مصفوفة كائنات JSON جدول CSV. كل كائن يصبح صفًا، ومفاتيح الكائنات تصبح عناوين الأعمدة. فقائمة سجلات بحقول name وemail وage تنتج CSV بتلك الأعمدة الثلاثة وصفًا لكل سجل، وهذا بالضبط ما يتوقعه جدول البيانات.
تحدي البيانات المتداخلة
CSV مسطح، شبكة بسيطة من الخلايا. أما JSON فلا؛ إنه يُدخل الكائنات والمصفوفات في بعضها بسهولة. وهذا التباين هو الأمر الرئيسي الذي يجب التخطيط له:
- الكائنات المتداخلة يجب تسطيحها. فكائن
addressفيهcityوzipيصبح عادةً أعمدة مثلaddress.cityوaddress.zip. - المصفوفات داخل سجل، كقائمة وسوم، لا تمثيل طبيعيًا لها في خلية واحدة. وكثيرًا ما تُضم في خلية واحدة أو تُوزع على أعمدة مرقمة.
- المفاتيح غير المتسقة. إذا كانت بعض السجلات تحتوي حقولًا تفتقدها أخرى، فيحتاج CSV إلى عمود لكل مفتاح يظهر، مع خلايا فارغة حيث لا يملكه سجل.
وكلما كان JSON أنظف وأكثر تسطحًا، كان CSV أنظف. وقد تحتاج البيانات المتداخلة بعمق إلى إعادة تشكيل أولًا.
جهّز JSON أولًا
إذا كان JSON لديك فوضويًا أو لست متأكدًا من صحته، فمرّره عبر مدقق JSON ومنسّق JSON قبل التحويل؛ فالمصفوفة المعطوبة لن تتحول بنظافة. نسّق أولًا، وتأكد أن البنية مصفوفة مسطحة من الكائنات، ثم حوّل.
استخدامات شائعة
- تسليم البيانات لزملاء غير تقنيين في جدول بيانات.
- الاستيراد إلى Excel أو Google Sheets للتحليل.
- إنشاء تقرير من استجابة API.
- تحميل البيانات إلى أدوات لا تقبل إلا CSV.