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

CSV (القيم المفصولة بفواصل) هي أبسط صيغة للبيانات الجدولية — يمكن لأي جدول بيانات تصديرها. JSON (JavaScript Object Notation) هي الصيغة القياسية لواجهات برمجة تطبيقات الويب والتطبيقات الحديثة. التحويل بين الاثنين هو إحدى مهام البيانات الأكثر شيوعًا في التطوير.

متى تحتاج إلى تحويل CSV إلى JSON

• تحميل البيانات في تطبيق ويب — تعمل معظم أُطر JavaScript بشكل أصلي مع JSON، وليس CSV
• حمولات واجهات برمجة التطبيقات — إذا كانت لديك بيانات في جدول بيانات يجب أن تذهب إلى نقطة نهاية واجهة برمجة تطبيقات، فأنت بحاجة إلى JSON
• الاستيراد إلى قواعد البيانات — تقبل العديد من قواعد بيانات NoSQL (MongoDB وFirebase) JSON مباشرة
• ملفات التكوين — تحويل جدول بيانات بإعدادات إلى ملف تكوين JSON
• تحليل البيانات — تحويل البيانات المصدَّرة إلى صيغة يمكن لأدواتك معالجتها

كيف يصبح CSV ملف JSON

ملف CSV:

name,age,city
Alice,30,New York
Bob,25,London

يصبح مصفوفة JSON من الكائنات:

[
  {"name": "Alice", "age": "30", "city": "New York"},
  {"name": "Bob", "age": "25", "city": "London"}
]

يصبح السطر الأول (العناوين) المفاتيح. يصبح كل سطر تالٍ كائنًا.

كيفية التحويل

1. الصق بيانات CSV الخاصة بك — أدخل بيانات مفصولة بفواصل بسطر عناوين.
2. اختر الفاصل الخاص بك — فاصلة أو فاصلة منقوطة أو علامة جدولة أو شريط عمودي. تكتشف الأداة تلقائيًا في معظم الحالات.
3. انسخ أو نزّل — راجع مخرج JSON وانسخه إلى الحافظة أو نزّله كملف .json.

التعامل مع ملفات CSV الصعبة

القيم بين علامات اقتباس — عندما تحتوي قيمة على حرف الفاصل (مثل عنوان بفاصلة)، يجب أن تكون محاطة بعلامات اقتباس مزدوجة: "New York, NY". تتعامل المحوّلات الجيدة مع ذلك بشكل صحيح.

القيم الفارغة — تصبح الخلايا الفارغة سلاسل فارغة في JSON ("field": ""). إذا كنت تريد null، فستحتاج إلى معالجة المخرج لاحقًا.

القيم الرقمية — لا تحتوي CSV على أنواع. كل شيء نص. سيكون لمخرج JSON الأرقام كسلاسل ("30"، وليس 30). إذا كان تطبيقك يحتاج إلى أرقام حقيقية، فحلّلها بعد التحويل.

فواصل الأسطر في القيم — تحتوي بعض ملفات CSV على قيم متعدّدة الأسطر (محاطة بعلامات اقتباس). لا تتعامل جميع المحوّلات معها — اختبر ببياناتك.

نصائح

• تحقّق من العناوين — يجب أن يحتوي السطر الأول على أسماء أعمدة نظيفة وفريدة. ستنشئ المسافات أو الأحرف الخاصة أو العناوين المكرّرة مفاتيح JSON فوضوية.
• تحقّق من الفاصل — تستخدم ملفات CSV الأوروبية غالبًا الفاصلة المنقوطة بدلًا من الفاصلة (لأن الفاصلة تستخدم كفاصل عشري في العديد من البلدان). إذا بدا التحويل خاطئًا، جرّب فاصلًا آخر.
• نسّق المخرج — بعد التحويل، مرّر JSON عبر منسّق لجعله قابلًا للقراءة قبل استخدامه في مشروعك.
• تحقّق بالعيّنات — قارن بضعة أسطر من مخرج JSON مع CSV الأصلي للتأكّد من أن التطابق صحيح، خاصة للملفات ذات الأعمدة العديدة.