تحويل CSV إلى JSON للمطورين
حوّل بيانات CSV إلى مصفوفة JSON جاهزة للاستخدام في الكود، محلياً في متصفحك.
أسقط ملفك هنا أو انقر للتصفح
ملفات CSV (.csv)
بياناتك لا تغادر جهازك
لا شيء تحذفه لاحقاً
آمن لمخرجات العملاء
يعمل في كل متصفح حديث
كيف تعمل
- 1
أضف ملف CSV
أسقِط الملف على الصفحة، أو انقر لتصفّح جهازك واختياره.
- 2
راجع المفاتيح
تأكّد أن صف العناوين أنتج أسماء الخصائص التي تتوقّعها قبل النسخ.
- 3
انسخ JSON أو نزّله
خذ المصفوفة مباشرةً إلى جسم طلب، أو ملف بذور، أو بيانات اختبار.
لماذا تستخدم هذه الأداة
صف العناوين يصير مفاتيح
السطر الأول يمنح أسماء الخصائص، فيصل كل صف كائناً مقروءاً لا مصفوفةً موضعية.
مخرَج JSON صالح
علامات الاقتباس والخطوط المائلة العكسية وفواصل الأسطر داخل القيم تُهرَّب، فيُحلَّل الناتج بدل أن يرمي خطأ صياغة.
كشف الفاصل
الفاصلة أو الفاصلة المنقوطة أو مسافة الجدولة تُقرأ من الملف لا تُفترض، وهذا مهمّ لمخرجات جداول البيانات الأوروبية والعربية.
لا شيء يُرفع
التحليل يجري في متصفحك — والبيانات لا تصل إلى خادم.
بلا حدّ للصفوف
المحدّد ذاكرة جهازك فقط، لا سقف باقة مجانية على عدد الصفوف أو حجم الملف.
مجاني بلا حساب
بلا تسجيل، وبلا علامة مائية، وبلا حدّ لعدد الملفات التي تحوّلها.
كل شيء في CSV نصّ، وJSON يعرف الفرق
هذه هي الخاصية الحاسمة في هذا التحويل. ملف CSV بلا أنواع: فـ`42` و`true` و`2024-03-15` كلها محارف فحسب، والمعنى يمنحه أياً كان من يقرأ الملف. أما JSON فله أنواع — عدد ومنطقي ونصّ وفارغ — فيضطر المحوّل أن يقرّر لكل خلية: هل يُخرج `42` أم `"42"`؟ ولا جواب صحيح على الإطلاق. فوضع كل شيء بين علامتَي اقتباس آمن ويُلزم الشيفرة المستقبِلة بالتحويل؛ والتحويل الجريء مريح ويدمّر البيانات، لأن رمز منتج `007` يصير العدد 7، ورقم هاتف يبدأ بعلامة زائد يصير شيئاً غير مفهوم. انظر إلى ما خرج قبل استعماله، وعامل المعرّفات نصوصاً عن قصد بدل الأمل في أن يكون التخمين قد وافق هواك.
لماذا يهمّ صف العناوين هنا أكثر من جدول البيانات
في جدول البيانات، العنوان تسمية يقرأها إنسان. أما في JSON فيصير اسم خاصية تعتمد عليه الشيفرة. وهذا يغيّر ما يجعل العنوان جيداً. فـ`Customer Name` مقبول في Excel وثقيل في الشيفرة حيث تريد `customer_name`؛ والعنوان المكرّر يطمس حقلاً بصمت، لأن الكائن لا يملك مفتاحين متطابقين؛ وخلية العنوان الفارغة تُنتج خاصية بلا اسم. وأسوأها مسافة في البداية أو النهاية، لأن `"name "` و`"name"` يبدوان متطابقين على الشاشة وهما مفتاحان مختلفان تماماً. أصلح صف العناوين قبل التحويل لا ملف JSON بعده.
الشكل الذي تحصل عليه والشكل الذي قد تحتاجه
المخرَج هنا مصفوفة كائنات — كائن لكل صف، ومفاتيح من العناوين. وهو ما تتوقّعه معظم الواجهات البرمجية وأدوات البذور ومكتبات JavaScript، ويبقى مقروءاً حين يفتحه إنسان. لكنه ليس الشكل الوحيد الممكن: فبعض الأنظمة تريد مصفوفة مصفوفات يكون العناوين أول عناصرها، وبعضها يريد الكلّ ملفوفاً في غلاف مثل `{"data": [...]}`. وليست هذه مشكلة تحويل بقدر ما هي تعديل من خمس ثوانٍ بعد حصولك على المصفوفة — لُفَّها أو أعد تشكيلها في محرّرك بدل البحث عن محوّل يُخرج نسختك بالضبط.
CSV مسطّح وJSON ليس كذلك
ملف CSV مستطيل: صفوف وأعمدة بلا تداخل. أما JSON فيستطيع التعبير عن كائنات داخل كائنات ومصفوفات داخلها. فالتحويل من CSV لا يُنتج إلا بنية مسطّحة، وإن كانت وجهتك تتوقّع تداخلاً — طلب يحمل قائمة أصناف، أو مستخدم يحمل كائن عنوان — فيجب فكّ التسطيح في الشيفرة بعدها. والعُرف الشائع أن تُرمَّز البنية في العنوان نفسه مثل `address.city` و`address.postcode`، ثم تُوسَّع تلك المفاتيح المنقّطة بعد التحويل. ومعرفة ذلك سلفاً تعفيك من الاستنتاج بأن المحوّل معطوب وهو يُنتج بأمانة ما يحتويه ملف مسطّح بالضبط.
فيمَ يُستعمل هذا عادةً
التحويل خطوةٌ في إدخال بيانات واقعية إلى شيفرة، في الغالب الأعمّ. فملف CSV من عميل يصير بيانات بذور لقاعدة بيانات. وجدول حالات اختبار يصير مادة تثبيت لمجموعة اختبارات. وقائمة أسعار تصير جسم طلب لتحديث بالجملة عبر واجهة برمجية. ومخرَج محتوى يصير ملف البيانات وراء بناء موقع ساكن. وفي كل واحدة من هذه الحالات تكون الوجهة برنامجاً لا شخصاً، ولهذا يكون الهدف JSON لا Excel — فالمصنّف للزميل الذي سيقرأه، وJSON للشيفرة التي ستستهلكه.
لماذا يهمّ التحويل محلياً لهذا النوع من الملفات
ملفات CSV التي يحوّلها الناس إلى JSON مخرجاتٌ: جداول عملاء، وسجلّات طلبات، وقوائم مستخدمين، وكتالوجات منتجات. والمحوّل المستضاف يستقبلها كاملة، والملف يحوي غالباً بيانات شخصية تتحمّل الجهة مسؤوليتها القانونية. ولأن هذه الأداة تعمل في متصفحك بالكامل، يُقرأ الملف من القرص إلى الصفحة ويُكتب JSON منها دون أن يحمله طلب شبكة، ويمكنك التأكد في تبويب الشبكة بأدوات المطوّر. ولصق مخرَج عملاء في محوّل عشوائي على الإنترنت من أشيع حوادث البيانات الصامتة في الشركات الصغيرة، وهو قابل للتفادي بالكامل.
أخطاء شائعة يجب تجنّبها
- ترك المعرّفات تتحوّل إلى أعداد. رمز منتج `007` يصير 7، ورقم حساب طويل يفقد دقّته؛ عامل أعمدة المعرّفات نصوصاً عن قصد بدل قبول ما أنتجه تخمين النوع.
- التحويل قبل إصلاح صف العناوين. خلايا العناوين تصير أسماء خصائص — فالمكرّر يطمس حقلاً بصمت، والفارغ يُنتج مفتاحاً بلا اسم، والمسافة الزائدة تجعل `"name "` مفتاحاً مختلفاً عن `"name"`.
- توقّع مخرَج متداخل من ملف مسطّح. ملف CSV مستطيل؛ فإن احتاجت الوجهة كائنات داخل كائنات، فرمّز التداخل في العناوين مثل `address.city` ووسّع المفاتيح المنقّطة بعد التحويل.
- افتراض أن JSON آمن للّصق في أي مكان لأنه حُلِّل بنجاح. فـJSON الصالح قد يحمل أنواعاً خاطئة — افحص بضعة صفوف من الأعداد والقيم المنطقية والتواريخ قبل توصيله بنظام.
- رفع مخرَج عملاء إلى محوّل على الإنترنت لتوفير دقيقتين. الملف غالباً بيانات شخصية تتحمّل جهتك مسؤوليتها؛ حوّله محلياً بدلاً من ذلك.
كيف تُقارن
| الميزة | هذه الأداة | المحوّلات على الإنترنت | سكربت تكتبه بنفسك |
|---|---|---|---|
| رفع البيانات إلى خادم | أبداً | عادةً نعم | لا |
| إعداد مطلوب | لا شيء | لا شيء | بيئة تشغيل وحزم |
| كشف الفاصل | نعم | عادةً | ما تبرمجه أنت |
| حدّ الصفوف | ذاكرة الجهاز فقط | محدود غالباً | لا يوجد |
| حساب أو تسجيل | غير مطلوب | مطلوب غالباً | غير مطلوب |
| السعر | مجاني | مجاني / باقات مدفوعة | وقتك |
المزايا
مخرَج مصفوفة كائنات
الشكل الذي تتوقّعه كل واجهة برمجية ومكتبة تقريباً، لا مصفوفة مصفوفات متداخلة.
كشف تلقائي للفاصل
فاصلة أو فاصلة منقوطة أو جدولة — تُفحص من الملف بدل افتراضها.
تهريب صحيح
علامات الاقتباس والخطوط المائلة والجدولات وفواصل الأسطر داخل القيمة تُهرَّب فيبقى JSON صالحاً.
حفظ ترميز UTF-8
العربية والتركية واللاتينية المشكّلة وغيرها تمرّ دون تغيير.
احترام الحقول المقتبسة
الفاصلة داخل علامتَي اقتباس تبقى جزءاً من القيمة بدل أن تشقّ السجلّ.
يدعم الملفات الكبيرة
عشرات آلاف الصفوف تُحوَّل بلا طابور رفع.
بلا تثبيت
لا شيء يُنزَّل أو يُثبَّت — يعمل على صفحة الويب مباشرة.
يدعم العربية والاتجاه من اليمين
واجهة كاملة بثماني لغات، منها العربية بالاتجاه الصحيح.
آمن افتراضياً
عبر HTTPS، بلا تتبّع للملفات وبلا رفع لأي طرف ثالث.
من يستخدمها
المطوّرون
تحويل جدول عميل إلى بيانات بذور أو مادة تثبيت اختبار بلا كتابة سكربت مؤقّت.
مهندسو الجودة
تحويل ورقة حالات اختبار إلى ملف تحمّله مجموعة الاختبارات مباشرة.
مطوّرو التكاملات
بناء جسم طلب تحديث بالجملة من مخرَج أسعار أو مخزون.
بناة المواقع الساكنة
تحويل مخرَج محتوى إلى ملف بيانات JSON تقرأه خطوة البناء.
الأسئلة الشائعة
لا. يتم التحويل بالكامل في متصفحك — بياناتك لا تُرفع أو تُخزَّن أو تُشارَك أبداً.
نعم. تُحوَّل كل صفوفك وأعمدتك بأمانة؛ يصبح الصف الأول أسماء الحقول.
نعم — مجاني تماماً، بلا حساب أو علامة مائية أو حد لعدد الملفات.