محوّل CSV إلى JSON

ما هو JSON ولماذا التحويل من CSV؟

// Input CSV (comma + LF, header on, infer types on)
id,name,active,score
1,Alice,true,98.5
2,Bob,false,87
3,Carol,true,

// Output JSON
[
  { "id": 1, "name": "Alice", "active": true, "score": 98.5 },
  { "id": 2, "name": "Bob", "active": false, "score": 87 },
  { "id": 3, "name": "Carol", "active": true, "score": null }
]

// Same input with Header off (no first-row keys)
1,Alice,true,98.5
2,Bob,false,87

// Becomes
[
  { "col1": 1, "col2": "Alice", "col3": true, "col4": 98.5 },
  { "col1": 2, "col2": "Bob", "col3": false, "col4": 87 }
]

الميزات الرئيسية

أمثلة

id,name,email,role
1,Alice,alice@example.com,admin
2,Bob,bob@example.com,editor
3,Carol,carol@example.com,viewer
4,Dan,dan@example.com,viewer

ts	event	user	duration
2026-05-09T10:00:00Z	signup	alice	142
2026-05-09T10:01:00Z	login	alice	87
2026-05-09T10:02:00Z	checkout	alice	312
2026-05-09T10:03:00Z	logout	alice	44

id;name;price
1;Alice;1234,56
2;Bob;9876,54
3;Carol;42,00

name,role,note
"Smith, Jr.",admin,"He said ""hi"""
"Doe, Jane",editor,"Two
lines"

id,event,user
9007199254740993,signup,alice
9007199254740994,login,bob
9007199254740995,checkout,carol

1,Alice,admin
2,Bob,editor
3,Carol,viewer
4,Dan,viewer

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

1. 1

   الصق CSV الخاص بك

   أدخل أو الصق CSV الخاص بك في حقل الإدخال أعلاه. تقبل الأداة بيانات محدّدة بفاصلة وفاصلة منقوطة وعلامة جدولة وأنبوب. يمكنك أيضاً النقر على «تحميل مثال» لتجربة عينة كتصدير جدول، أو سجل TSV، أو CSV بصيغة Excel-EU بفواصل منقوطة.

2. 2

   اختر المحدّد (أو علامة الجدولة)

   انقر على `,` (الافتراضي)، أو `;` (فاصلة منقوطة Excel-EU)، أو `\t` (TSV)، أو `|` (أنبوب) لتبديل المحدّد بنقرة واحدة. افتح لوحة الخيارات للتحكم الدقيق: تفعيل/تعطيل صف العنوان وتفعيل/تعطيل استنتاج الأنواع. تعطيل صف العنوان يُسمّي الأعمدة تلقائياً col1، col2، col3.

3. 3

   انسخ أو حمّل JSON

   انقر على «انسخ» لنقل JSON إلى الحافظة، أو «تحميل» لحفظه كملف .json جاهز لكودك أو API أو خط بياناتك. لرحلات الذهاب والعودة، انقر على «تبديل الاتجاه» لتحويل JSON إلى CSV في مكانه.

أخطاء التحويل الشائعة

name,role
Smith, Jr.,admin
// Parser reads 3 columns: "Smith", " Jr.", "admin"

name,role
"Smith, Jr.",admin
// Parser reads 2 columns: "Smith, Jr.", "admin"

// Wrong delimiter (default comma) on Excel-EU file
id;name;price
1;Alice;1234,56
// Each row becomes one column: { col1: "1;Alice;1234,56" }

// Correct: pick `;` Delimiter chip
id;name;price
1;Alice;1234,56
// Output: { id: 1, name: "Alice", price: "1234,56" }

// Without big-int detection
{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

// With Infer types on, big integers stay as strings
{"id": "9007199254740993"}
// Use BigInt(value) in code to preserve precision

id, name, email
1, Alice, alice@example.com
// Output keys: "id", " name", " email" (with leading spaces)

id,name,email
1,Alice,alice@example.com
// Output keys: "id", "name", "email" (clean)

name,role,note
Alice,admin
Bob,editor,first day
// Row 1 is short by one cell

// Output (note empty/null cell in row 1)
[
  { "name": "Alice", "role": "admin", "note": null },
  { "name": "Bob", "role": "editor", "note": "first day" }
]

// Expecting a Date object in the output
ts,event
2026-05-09T10:00:00Z,signup
// Output ts is the string "2026-05-09T10:00:00Z", NOT a Date

// Correct: parse at the point of use in your code
const rows = JSON.parse(output);
const when = new Date(rows[0].ts);
// when is now a Date object

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

تصدير جدول إلى استيراد API

الصق CSV مُصدَّراً من Excel أو Google Sheets أو Numbers واحصل على مصفوفة JSON من الكائنات جاهزة لـ POST إلى REST API، أو طفرة GraphQL، أو نقطة استيراد جماعي. الحالة الأكثر شيوعاً — يُنتج المحلّلون بيانات الجداول، ويحتاج المهندسون إلى JSON مكتوب بدقة لتغذية الواجهة الخلفية.

تصدير Excel إلى الأدوات

حوّل تصديرات Excel CSV (بما فيها ملفات Excel-EU المحدّدة بفاصلة منقوطة عبر شريحة `;`) إلى JSON للمعالجة بأدوات JavaScript، أو نصوص jq، أو أي نظام يقرأ JSON. يتعامل المحلّل مع إسقاط BOM ونهايات الأسطر CRLF بشكل صحيح فلا تتعطل تصديرات Excel على الصف الأول.

سجل TSV إلى التحليلات

السجلات المفصولة بعلامات جدولة من تصديرات BigQuery، أو إلغاءات تحميل Snowflake، أو خطوط Vector، أو أدوات Unix (cut، awk) كثيراً ما تصل كـ .tsv. اختر شريحة محدّد علامة الجدولة واحصل على مصفوفة JSON مكتوبة بدقة جاهزة للتحليل الخاص، أو إدخال لوحة المعلومات، أو تحويل مرحلة الخط.

تفريغ CSV لقاعدة البيانات إلى ETL

حوّل إخراج PostgreSQL COPY TO CSV، أو MySQL SELECT INTO OUTFILE، أو أي تفريغ CSV لقاعدة بيانات إلى JSON للتحميل إلى مخزن NoSQL، أو التغذية في خط ETL بـ JavaScript، أو الشحن إلى BigQuery كـ JSON محدّد بأسطر. يحفظ اكتشاف الأعداد الصحيحة الكبيرة المعرّفات العددية التي تتجاوز النطاق الآمن في JavaScript.

استهلاك نتائج اختبارات Postman/Newman بصيغة CSV

تشغيلات اختبارات Postman تُصدّر تقارير CSV لنجاح/فشل كل طلب. حوّل إلى JSON للاستهلاك البرمجي — تغذية في لوحة حالة، أو خط تنبيه، أو مُجمّع نتائج اختبارات. الصفوف بأشكال مختلطة (الاختبارات الفاشلة بها عمود error إضافي) تُعالَج بملء فارغ/null.

CSV صغير إلى إعدادات JSON سريعة

هل لديك CSV صغير من الثوابت — رموز العملات، أسماء الدول، رموز SKU للمنتجات — وتحتاج مصفوفة JSON لملف إعدادات أو ثابت JavaScript؟ الصق، انسخ، الصق. مع تفعيل استنتاج الأنواع، تُكتب الأرقام والقيم المنطقية بشكل صحيح؛ مع تفعيل صف العنوان، تحصل على مصفوفة من كائنات الحقول المسماة جاهزة لإسقاطها في ملف .json.

تفاصيل تقنية

آليات محلّل آلة الحالة لـ RFC 4180

المحلّل تطبيق آلة حالة منتهية صحيح يتبع RFC 4180. تشمل الحالات UnquotedField، وQuotedField، وAfterQuote، وRowEnd، وEndOfInput. يتعامل المحلّل بشكل صحيح مع الحقول المقتبسة المحتوية على المحدّد، وCR/LF المضمَّنة داخل الحقول المقتبسة، وعلامات الاقتباس المزدوجة المهرَّبة (مضاعفة، مثل "")، والأسطر الجديدة الزائدة. هذا يُنتج إخراجاً يدعم الذهاب والعودة دون فقدان عبر وحدة csv في Python، وPostgreSQL COPY، وAWS S3 SELECT، وأي محلّل متوافق. آلة الحالة واعية بالمحدّد، فالتبديل من `,` إلى `;` أو `\t` لا يُغيّر دلالات الاقتباس — فقط فاصل الحقل.

خوارزمية استنتاج الأنواع

مع تفعيل استنتاج الأنواع، تمر كل خلية عبر مسار اكتشاف مرتّب. أولاً، الخلية الفارغة تصبح null في JSON. ثانياً، السلاسل الحرفية true وfalse تصبح قيماً منطقية في JSON. ثالثاً، السلاسل ذات الأصفار البادئة (^0[0-9]+$) تبقى كسلاسل للحفاظ على دلالات المعرّف — التحويل إلى أرقام سيُسقط الأصفار البادئة بصمت. رابعاً، الأعداد الصحيحة الحرفية تُختبر مقابل حد العدد الصحيح الآمن (-2^53+1 إلى 2^53-1)؛ القيم خارج هذا النطاق تبقى كسلاسل لتجنّب فقدان دقة IEEE 754. خامساً، سلاسل تواريخ ISO 8601 تُكتشف بتعبير منتظم وتبقى عمداً كسلاسل — لا يحتوي JSON على نوع تاريخ أصلي. كل ما ينجو من الحراس الخمسة يُحوَّل عبر Number() (عددي) أو يبقى سلسلة (كل ما عداها).

إسقاط BOM ومعالجة الترميز

كل المدخلات تُعامَل كـ UTF-8. UTF-8 BOM الاختياري (0xEF 0xBB 0xBF) يُسقَط بصمت من الخلية الأولى للصف الأول عند وجوده — هذا يمنع تضمين بايتات BOM كحرف ضائع في بداية اسم العمود الأول (Excel على Windows يُنتج BOM عادة، مما يُعطّل المحلّلات الساذجة). الترميزات الأخرى (Windows-1252، ISO-8859-1) لا تُكتشف تلقائياً؛ ستكون File API في المتصفح قد فكّت ترميز البايتات كـ UTF-8 بحلول وقت وصول النص إلى هذه الأداة. إذا كان لديك مدخل غير UTF-8، حوّله أولاً بـ iconv أو خيار تصدير الترميز في محرّرك قبل اللصق.

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

اختر المحدّد صراحةً للبيانات غير ذات الفاصلة

لا تعتمد على الاكتشاف التلقائي. إذا كان CSV الخاص بك يستخدم فواصل منقوطة (Excel-EU)، أو علامات جدولة (TSV من BigQuery، أو Snowflake، أو أدوات Unix)، أو أنابيب (حقول كثيرة الفواصل)، انقر على شريحة المحدّد المطابقة قبل اللصق. المحلّل واع بالمحدّد: تبديل الشريحة يُعيد تحليل المدخل فوراً. هذا يتجنّب وضع الفشل الأكثر شيوعاً في تحويل CSV إلى JSON حيث ينهار كل صف إلى خلية واحدة لأن المحلّل استخدم الفاصل الخطأ.

أبق استنتاج الأنواع مفعّلاً لـ JSON مكتوب بدقة

مع تفعيل استنتاج الأنواع (الافتراضي)، تحصل على JSON مكتوب بدقة: أرقام كأرقام، وقيم منطقية كقيم منطقية، وnull حيث تظهر خلايا فارغة. هذا ما يريده معظم المستهلكين — API، الواجهات الأمامية، كود JavaScript. عطّل استنتاج الأنواع فقط عندما تحتاج تحديداً كل خلية كسلسلة لمستهلكين صارمي الأنواع لاحقاً، أو خطوط تحقق تقارن بايتات المصدر بدقة. يحتوي مسار الاكتشاف على حراس للسلاسل ذات الأصفار البادئة، والأعداد الصحيحة الكبيرة، وتواريخ ISO، فتبقى المعرّفات والتواريخ آمنة حتى مع تفعيل الاستنتاج.

اقتبس المعرّفات كسلاسل في CSV المصدر

إذا كان CSV الخاص بك مولّداً من قاعدة بيانات أو خط تتحكم به، أنتج المعرّفات العددية الكبيرة (سنوفليك Twitter، معرّفات Discord، resourceVersion في K8s) كسلاسل CSV مقتبسة ("9007199254740993") لتمر عبر استنتاج الأنواع بنظافة. سيحفظها المحلّل كسلاسل في كلتا الحالتين (يلتقط اكتشاف الأعداد الصحيحة الكبيرة القيم فوق 2^53 - 1)، لكن الاقتباس الصريح هو العقد المنبعي الأكثر متانة ويتجنّب أي لبس حول الدقة.

صف العنوان يجب أن يكون السطر الأول

تفعيل صف العنوان (الافتراضي) يكتشف تلقائياً الصف الأول كأسماء أعمدة. إذا كان CSV الخاص بك يحتوي على تعليقات أو أسطر فارغة أو بيانات وصفية قبل العنوان، اقتطعها قبل اللصق — لا يتخطى المحلّل الأسطر غير البيانية البادئة. لـ CSV بدون عنوان (تصديرات خام، تفريغات مولّدة آلياً)، عطّل صف العنوان وستُسمّى الأعمدة تلقائياً col1، col2، col3 بالترتيب. لا تحاول تزييف عنوان بإلصاقه ببداية ملف بدون عنوان؛ إما عطّل صف العنوان أو أصلح المصدر.

استخدم وضع التحويل النصي لرحلات CSV ← JSON ← CSV

إذا كنت تخطط لرحلة ذهاب وعودة لبياناتك عبر كلا الاتجاهين (CSV ← JSON ← CSV)، يحتاج الاتجاه العكسي (JSON ← CSV) إلى وضع التحويل النصي لأي مصفوفات أو كائنات متداخلة لتنجو دون فقدان. وضع التسطيح في الاتجاه العكسي يُنتج مفاتيح بنقاط (customer.address.city) لا يستطيع محلّل CSV إعادة بنائها بدقة. شاهد محوّل JSON إلى CSV لمرجع الاتجاه العكسي الكامل وملاحظات اختبار رحلة الذهاب والعودة.

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