CSV إلى JSON
حوّل بيانات CSV أو TSV إلى مصفوفة JSON منظمة مع استخدام الصف الأول أسماءً للحقول. يدعم القيم بين علامات التنصيص والفواصل داخلها وملفات UTF-8 مع BOM.
حوّل بيانات CSV أو TSV إلى مصفوفة JSON نظيفة من كائنات، مع استخدام الصف الأول أسماءً للحقول. وتُعالَج بشكل صحيح القيم الواقعة بين علامات تنصيص والفواصل داخلها وعلامات التنصيص المُهرَّبة وملفات UTF-8 التي تحمل BOM، وهي بالضبط ما تخطئ فيه معظم السكربتات الساذجة التي تقسم على الفواصل.
وهذا هو عكس خطوة التصدير: خذ جدولاً يُصان يدوياً، وحوّله إلى JSON، وقدّمه إلى تطبيق أو مولّد موقع ساكن أو بيانات اختبار. وتُحوَّل الأرقام والقيم true وfalse إلى أنواعها في JSON، فلا تحتاج إلى تنظيفها بعد ذلك.
كيفية تحويل CSV إلى JSON
الصق بيانات CSV أو TSV
اختر الفاصل إن لم يكن فاصلة
انسخ JSON أو نزّله
الأسئلة الشائعة
هل تُعالَج الحقول الواقعة بين علامات تنصيص؟
نعم. القيم المحصورة بين علامتي تنصيص مزدوجة قد تضم فواصل وأسطراً جديدة وعلامات تنصيص مُهرَّبة، وهذا هو الجزء الذي تخطئ فيه معظم المحوّلات البسيطة.
أي فاصل أختار؟
الفاصلة لملفات CSV القياسية، والفاصلة المنقوطة للملفات التي يصدّرها Excel في كثير من البيئات الأوروبية، وحرف الجدولة لبيانات الحافظة المنسوخة من جدول.
هل تُحوَّل الأرقام إلى أرقام؟
القيم التي تبدو رقمية تصبح أرقاماً في JSON، وتصبح true وfalse قيماً منطقية، فتكون النتيجة جاهزة للاستخدام دون تحليل إضافي. ويمكنك إجبارها على أن تكون نصوصاً لاحقاً إن تطلب مخططك ذلك.
وماذا عن BOM بترميز UTF-8 في بداية الملف؟
يُحذف تلقائياً، فلا يظهر اسم العمود الأول بحرف غير مرئي أمامه.
كيف تُمثَّل الخلايا الفارغة؟
كنص فارغ. احذفها أو حوّلها بعد ذلك إن كان مخططك يتوقع null بدلاً من ذلك.
هل تُرفع بياناتي؟
لا، يجري التحليل محلياً في متصفحك.
نظرة سريعة
| المدخل | CSV |
|---|---|
| عدة ملفات | لا |
| مكان التشغيل | في متصفحك، ولا تُرفع الملفات أبداً |
| يعمل دون اتصال | نعم — بعد تحميل الصفحة |
| السعر | مجاني، بلا تسجيل وبلا علامة مائية |
اختيار صيغة البيانات
JSON هو الصيغة الافتراضية لكل ما تُرجعه واجهة API أو يقرأه برنامج: فهو يتعامل بطبيعته مع البنى المتداخلة والأرقام والقيم المنطقية وnull، وكل لغة تحلّله. أما CSV فأصغر حجماً ويُفتح مباشرة في جدول بيانات، لكنه لا يملك وسيلة للتعبير عن التداخل ولا معياراً مشتركاً للفاصل أو التنصيص أو مجموعة المحارف، وهذا بالضبط موضع الخطأ في التحويلات. أما XML فمطوّل لكنه يحمل السمات والمحتوى المختلط والمخططات، ولذلك ما زال مهيمناً على صيغ المستندات والتكاملات القديمة. وYAML هو الأسهل قراءةً في الإعدادات لكنه حساس للمسافات البيضاء وفيه إكراه مفاجئ للأنواع («no» تصبح false، وإصدار مثل 1.10 يصبح 1.1). فاختر الصيغة التي تفضّلها الأداة المستهلكة لا الصيغة الأجمل منظراً.
أين تنكسر التحويلات بهدوء
معظم أخطاء التحويل لا تتعلق بالصياغة بل بالمعنى. فعمود من الرموز البريدية في ملف CSV يفقد أصفاره البادئة في اللحظة التي يخمّن فيها جدول البيانات أنه رقم؛ ومعرّف طويل يتجاوز دقة الفاصلة العائمة؛ والتواريخ يتغير معناها بحسب ما إذا كان اليوم أولاً أم الشهر أولاً. ومفاتيح JSON غير مرتبة أما المصفوفات فمرتبة، والأداة التي ترتب المفاتيح لا تغيّر شيئاً بينما التي ترتب المصفوفات تغيّر البيانات. وUnicode فخ آخر: فقد يصل النص بترميز UTF-8 أو UTF-16 أو مع علامة ترتيب البايتات، وفاكّ الترميز الذي يخمّن خطأً يحوّل المحارف المشكّلة إلى نص مشوّه. وقبل أن تثق بأي تحويل، افحص الصف الأول والأخير، وكل حقل فيه أصفار بادئة، وكل حقل يحتوي على علامات تنصيص أو فواصل أو أسطر جديدة.