محول مجاني

محول CSV إلى JSON

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

اختر ملف CSV

أو قم بالسحب والإفلات هنا

أو

حول هذه الأداة

يعد كل من CSV (قيم مفصولة بفواصل) وJSON (JavaScript Object Notation) من تنسيقات تبادل البيانات المنتشرة في كل مكان، لكنهما يصفان البيانات بشكل مختلف. ملف CSV مسطح ومجدول: يحدد صف الرأس أسماء الحقول، ويحتفظ كل صف لاحق بقيم سجل واحد. JSON ذو تسلسل هرمي: يتم تنظيم البيانات ككائنات (أزواج قيمة المفتاح) ومصفوفات، مما يدعم التداخل والأنواع الأكثر ثراءً. يعني تحويل CSV إلى JSON عادةً تحويل كل صف CSV إلى كائن JSON تأتي مفاتيحه من صف الرأس وتكون قيمه هي خلايا الصف.

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

يتم دعم تنسيقين للإخراج. تنتج مصفوفة الكائنات (الافتراضية) [{header1: value1, header2: value2}, ...]، وهو شكل JSON الأكثر شيوعًا للبيانات الجدولية. تنتج صفيف المصفوفات [[header1, header2], [value1, value2], ...]، مع الحفاظ على ترتيب الأعمدة دون استخدام أسماء الرؤوس كمفاتيح.

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

تتحدث معظم واجهات برمجة التطبيقات والتطبيقات الحديثة لغة JSON. عادةً ما يتطلب تحميل البيانات من تصدير CSV — تقرير مبيعات، أو قائمة جهات اتصال، أو مستخلص قاعدة بيانات — إلى تطبيق JavaScript، أو REST API، أو قاعدة بيانات NoSQL المرور عبر JSON أولاً. يعد التحويل أيضًا الخطوة الأولى للعديد من عمليات تحويل البيانات، نظرًا لأن معالجة JSON أسهل برمجيًا من ملف CSV.

تفتح بنية JSON أيضًا الميزات التي لا يمكن لملف CSV تمثيلها. تصبح الكائنات ذات الخصائص المتداخلة والمصفوفات ذات الطول المتفاوت لكل سجل ومعلومات النوع الصريحة (السلاسل مقابل الأرقام مقابل القيم المنطقية) متاحة بمجرد أن تكون البيانات بتنسيق JSON. توجد بدائل CSV مثل TSV ولكنها تشترك في نفس قيود التسطيح.

كيفية الاستخدام

قم بلصق أو تحميل ملف CSV الخاص بك، واحصل على JSON.

  1. أضف ملف CSV الخاص بك: الصق نص CSV في منطقة الإدخال أو قم بإسقاط ملف .csv. يقوم PapaParse بالكشف التلقائي عن المحددات؛ الفاصلة هي الأكثر شيوعًا، لكن علامة التبويب والفاصلة المنقوطة والتوجيه تعمل أيضًا.
  2. اختر تنسيق الإخراج: تستخدم مجموعة الكائنات الرؤوس كمفاتيح وتنتج شكل JSON الأكثر شيوعًا. تحافظ صفيف المصفوفات على بنية الصف الأولية. اختر بناءً على ما يتوقعه المستهلك النهائي.
  3. تحويل: يعالج PapaParse ملف CSV في المتصفح، ويتعامل مع الحقول المقتبسة، وعلامات الاقتباس التي تم تجاوزها، وحالات الحافة. يتم إنشاء إخراج JSON مع الهروب المناسب للسلاسل التي تحتوي على أحرف خاصة.
  4. تنزيل أو نسخ: احفظه بتنسيق .json أو انسخه إلى الحافظة. الإخراج صالح للاستهلاك JSON بواسطة أي محلل JSON.

حالات الاستخدام الشائعة

التفاصيل الفنية

يقوم PapaParse بتطبيق RFC 4180 (مواصفات CSV) بالإضافة إلى ملحقات للتنوعات التي تحتوي عليها ملفات CSV في العالم الحقيقي. يمكن أن تتضمن الحقول المقتبسة فواصل وأسطر جديدة وأحرف اقتباس (تم تجاوزها بالمضاعفة). يتم اكتشاف الرؤوس، في حالة وجودها، من الصف الأول. يمكن كتابة القيم الرقمية والمنطقية تلقائيًا (تحويلها إلى أرقام فعلية أو منطقية بدلاً من سلاسل) أو الاحتفاظ بها كسلاسل.

يتم إنشاء إخراج JSON باستخدام JSON.stringify مع مسافة بادئة اختيارية. يتم تهريب السلاسل النصية لبناء جملة JSON (الشرطة المائلة العكسية، وعلامات الاقتباس، وأحرف التحكم)، وتستخدم الهياكل التنسيق المطلوب (صفيف من الكائنات أو صفيف من المصفوفات).

حالات الحافة التي تتم معالجتها: قائمة مكونات الصنف (BOM) عند بداية الملف، ونهايات الأسطر المختلطة (\n مقابل \r\n)، والخلايا الفارغة (يتم تقديمها كسلاسل فارغة أو فارغة اعتمادًا على الإعدادات)، وأسطر جديدة زائدة، وصفوف ذات أعداد حقول مختلفة. قوة PapaParse تجعلها مكتبة JavaScript CSV القياسية.

أفضل الممارسات

الأسئلة الشائعة

هل يؤدي تحويل CSV إلى JSON إلى تغيير المحتوى؟
يتم الحفاظ على المحتوى بأكبر قدر ممكن من الدقة. ومع ذلك، قد لا تحتوي بعض الميزات الخاصة بالتنسيق على مكافئات مباشرة، لذلك يمكن أن تحدث اختلافات بسيطة في التنسيق.
لماذا تحويل البيانات إلى تنسيق JSON؟
JSON هو تنسيق البيانات القياسي لواجهات برمجة تطبيقات الويب وتطبيقات JavaScript. إنها قابلة للقراءة من قبل الإنسان، ومدعومة على نطاق واسع بلغات البرمجة، ولها بناء جملة أبسط من XML.
هل يتعامل المحول مع بنيات CSV المتداخلة أو المعقدة؟
نعم. تقوم الأداة بتحليل الكائنات المتداخلة والمصفوفات وجميع أنواع بيانات CSV القياسية بشكل صحيح، مع الحفاظ على بنية البيانات الكاملة في مخرجات JSON.
هل هذا التحويل آمن وخاص؟
نعم. تتم جميع عمليات المعالجة محليًا في متصفحك. لا تترك بياناتك جهازك أبدًا - لا يوجد تحميل على الخادم، ولا معالجة سحابية، ولا جمع بيانات.
هل يتم تحميل بياناتي على الخادم؟
لا، يعمل PapaParse في متصفحك؛ يحدث التحويل بالكامل على جهازك.
هل يمكنني تحويل JSON مرة أخرى إلى CSV؟
نعم - استخدم أداة JSON إلى CSV، والتي تعكس العملية.
ما هو الحد الأقصى لحجم الإدخال؟
ما يصل إلى 50 ميغابايت. قد تتباطأ الملفات الأكبر حجمًا بسبب قيود ذاكرة المتصفح؛ بالنسبة للتحويلات على مستوى الإنتاج، يكون النهج من جانب الخادم أو النهج النصي أكثر موثوقية.
لماذا يتم تحويل ملف CSV الخاص بي الذي يحتوي على حقول متعددة الأسطر بشكل غريب؟
يعالج PapaParse الحقول متعددة الأسطر عند الاقتباس بشكل صحيح. إذا كانت النتيجة خاطئة، فتأكد من أن الحقول المقتبسة تستخدم علامات اقتباس مزدوجة حولها وأنه يتم تجاوز علامات الاقتباس الداخلية عن طريق المضاعفة ("").