كيفية تحويل CSV إلى JSON بدون Excel

ملفات CSV منتشرة لأنها بسيطة وسهلة التصدير من الجداول، أنظمة المتاجر، أدوات البريد، ولوحات التحليل. لكن كثيرا من التطبيقات وواجهات API لا تريد CSV، بل تريد JSON منظم يمكن قراءته ومعالجته بسهولة. الخبر الجيد أنك لا تحتاج إلى فتح Excel في كل مرة. إذا كان الملف نظيفا، يمكنك تحويله مباشرة ثم التحقق من النتيجة خلال دقائق.

ابدأ من صف العناوين

أهم جزء في CSV هو الصف الأول. هذا الصف يتحول غالبا إلى مفاتيح داخل JSON، لذلك يجب أن تكون أسماء الأعمدة واضحة وغير مكررة.

مثال جيد:

id,name,email,role
1,Ava,ava@example.com,Designer
2,Noah,noah@example.com,Developer

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

حول CSV إلى JSON

الصيغة الطبيعية لمعظم ملفات CSV هي مصفوفة من الكائنات:

[
  {
    "id": "1",
    "name": "Ava",
    "email": "ava@example.com",
    "role": "Designer"
  }
]

لاحظ أن القيم قد تظهر كنصوص حتى لو كانت أرقاما أو true و false. هذا شائع لأن CSV لا يحفظ نوع البيانات دائما. إذا كان النظام الذي سترسل إليه JSON يحتاج أرقاما حقيقية أو قيم boolean، راجع هذه الحقول بعد التحويل.

مشاكل CSV الشائعة

أكثر الأخطاء تحدث عندما يحتوي النص على فاصلة داخل القيمة. مثلا اسم منتج مثل Notebook, large يجب أن يكون بين علامات اقتباس:

sku,name,price
NB-01,"Notebook, large",12.99

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

متى تحتاج إلى جدول قبل التحويل؟

لا تحتاج إلى Excel للتحويل نفسه، لكن قد تحتاج إلى برنامج جدول عندما يكون الملف فوضويا. استخدمه إذا كنت تريد إزالة أعمدة فارغة، ترتيب أسماء الأعمدة، توحيد صيغة التاريخ، إزالة الصفوف المكررة، أو فصل الاسم الكامل إلى اسم أول واسم أخير.

إذا كان الملف نظيفا، التحويل المباشر أسرع. وإذا كان الملف غير نظيف، فتنظيفه أولا أفضل من إصلاح JSON بعد ذلك.

تحقق من النتيجة

بعد التحويل، افتح JSON في أداة تنسيق أو عارض JSON. اسأل نفسك:

• هل كل الأعمدة ظهرت كمفاتيح؟
• هل كل الكائنات لها نفس الشكل؟
• هل القيم الرقمية والتواريخ بصيغة مناسبة؟
• هل القيم التي تحتوي على فواصل بقيت سليمة؟
• هل JSON صالح بعد التنسيق؟

هذه الخطوة الصغيرة تمنع كثيرا من الأخطاء لاحقا. لا تنس أن التحويل الناجح شكليا لا يعني دائما أن البيانات مناسبة للاستخدام النهائي. راجع عينة صغيرة، ثم طبق نفس المسار على الملف الكامل.

أسئلة شائعة

هل يمكن تحويل CSV كبير جدا؟

يعتمد ذلك على حجم الملف وقوة المتصفح. إذا كان الملف ضخما جدا، جرب تحويل عينة صغيرة أولا للتأكد من أن العناوين والقيم تظهر بالشكل الصحيح. بعد ذلك قسم الملف أو استخدم مسارا مخصصا إذا كان الحجم يتجاوز قدرة المتصفح.

هل يجب أن تكون كل القيم بين علامات اقتباس؟

ليس دائما. القيم العادية لا تحتاج ذلك، لكن أي قيمة تحتوي على فاصلة أو سطر جديد أو علامة اقتباس تحتاج معالجة صحيحة. إذا لم تكن متأكدا، صدّر الملف من أداة موثوقة أو نظفه قبل التحويل.

لماذا تظهر الأرقام كنصوص؟

CSV لا يضمن نوع البيانات، لذلك قد تظهر الأرقام كنصوص بعد التحويل. هذا ليس خطأ دائما. إذا كان النظام التالي يحتاج أرقاما، عدل القيم أو مررها في خطوة معالجة إضافية.

ما أفضل طريقة لتجنب الأخطاء؟

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