محول JSON ↔ CSV
محول JSON ↔ CSV
يدعم التحويل JSON ↔ CSV التحويل المتبادل بين CSV وTSV وJSON، مع اكتشاف الفواصل، ومطابقة عناوين الأعمدة، وتنظيف الحقول، وهو مناسب لاستيراد البيانات وتصديرها، والعمل مع الجداول، وتحضير بيانات API.
الفاصل
المسافة البادئة لـ JSON
استخدام صف الرأس
إزالة الفراغات
تخطي الأسطر الفارغة
مخرجات JSON
⇄
مخرجات CSV
بداية سريعة
سيناريوهات شائعة
تحويل Excel إلى JSON
انسخ نطاق الخلايا من Excel (مفصولًا بعلامات تبويب) والصقه في جهة CSV لتحويله مباشرة إلى مصفوفة كائنات JSON.
تحويل استجابة API إلى جدول
حوّل استجابات JSON إلى CSV لتحليلها في Excel أو Google Sheets.
التحضير لاستيراد قاعدة البيانات
حوّل بيانات CSV إلى JSON لتسهيل الاستيراد الدفعي عبر API.
تحليل السجلات
حوّل سجلات CSV إلى JSON لإجراء استعلامات مهيكلة بأدوات مثل jq.
ترحيل الإعدادات
بدّل بين جداول المطابقة بصيغة CSV وملفات الإعداد بصيغة JSON.
تنظيف البيانات
استخدم تشذيب الحقول وتخطي الأسطر الفارغة لتنظيف البيانات المصدّرة من الأنظمة الخارجية بسرعة.
نصائح الاستخدام
القيود والتوافقية
الخصوصية والأمان
أسئلة شائعة
CSV (Comma-Separated Values) هو تنسيق جداول نصي بسيط، يمثّل كل سطر فيه سجلًا، وتُفصل الحقول بفواصل. أما TSV فهو نفس الفكرة لكن بعلامات تبويب بدل الفواصل. يستطيع Excel فتح وتصدير التنسيقين، لكن .xlsx بحد ذاته تنسيق ثنائي مختلف. هذه الأداة تتعامل مع CSV/TSV النصي فقط، وليس ملفات .xlsx. تاريخيًا لم يكن لـ CSV معيار موحد صارم، إلى أن جاء RFC 4180 عام 2005 ووضع القواعد الأساسية: فصل الحقول بالفاصلة، وتغليف الحقول ذات الأحرف الخاصة بعلامات اقتباس مزدوجة، وتهريب علامة الاقتباس داخل الحقل المقتبس على شكل علامتي اقتباس متتاليتين. وما زالت الفروقات التنفيذية بين البرامج سببًا شائعًا لمشكلات الاستيراد والتصدير.
تفحص الأداة السطر الأول وتحسب عدد الفواصل وعلامات التبويب والفواصل المنقوطة والخطوط العمودية (|) الظاهرة خارج الحقول المقتبسة، ثم تختار الأكثر تكرارًا كفاصل. هذا يعمل بدقة في معظم ملفات CSV/TSV القياسية. وقد يخطئ في حالات مثل وجود عمود واحد فقط (من دون فاصل)، أو احتواء القيم نفسها على عدد كبير من رموز الفواصل. عندها حدّد الفاصل يدويًا.
عند التفعيل يُعامل الصف الأول كأسماء أعمدة، وتتحول كل سطر بيانات إلى كائن JSON بمفاتيح تلك الأسماء (مثل {"name": "Alice", "age": "30"}). وعند التعطيل تُعامل كل الصفوف، بما فيها الصف الأول، كبيانات وتتحول إلى مصفوفة ثنائية الأبعاد (مثل [["name", "age"], ["Alice", "30"]]). وفي اتجاه JSON → CSV، يؤدي التفعيل إلى إخراج مفاتيح الكائن في الصف الأول من CSV.
ليس بالكامل. في JSON → CSV تُحوَّل الكائنات/المصفوفات المتداخلة إلى نص داخل الخلية عبر JSON.stringify. وعند CSV → JSON تبقى هذه القيم نصوصًا ولا تُفك تلقائيًا إلى كائنات. إذا كانت سلامة البنية مهمة، فقم بتسطيح JSON قبل التحويل.
نعم. عند نسخ نطاق خلايا من Excel ولصقه في محرر CSV، تكون البيانات عادة مفصولة بعلامات تبويب. يتعرف الوضع التلقائي عليها كـ TSV ويحوّلها بشكل صحيح. وإذا أردت تنزيل النتيجة بصيغة .csv مفصولة بفواصل، فغيّر الفاصل إلى الفاصلة قبل التنزيل.
تتبع الأداة RFC 4180: إذا احتوى الحقل على فاصل أو سطر جديد أو علامة اقتباس مزدوجة، يُغلَّف الحقل كاملًا بعلامات اقتباس مزدوجة. وتُهرَّب علامات الاقتباس داخل الحقل كعلامتي اقتباس متتاليتين (""). يطبَّق ذلك عند التحليل والإخراج معًا. وإذا وُجدت علامة اقتباس غير مغلقة، ستظهر رسالة «علامة اقتباس غير مغلقة في إدخال CSV».