محوّل JSON إلى CSV

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

// Input JSON
[
  { "id": 1, "name": "Alice", "role": "admin" },
  { "id": 2, "name": "Bob", "role": "editor" }
]

// Output CSV (RFC 4180 preset: comma + CRLF + no BOM)
id,name,role
1,Alice,admin
2,Bob,editor

// Same input with Stringify mode + nested data
[
  { "id": 1, "tags": ["a", "b"] }
]

// Becomes
id,tags
1,"[""a"",""b""]"

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

أمثلة

[{"id":1,"name":"Alice Chen","email":"alice@example.com","role":"admin"},{"id":2,"name":"Bob Garcia","email":"bob@example.com","role":"editor"},{"id":3,"name":"Carol Singh","email":"carol@example.com","role":"viewer"},{"id":4,"name":"Dan Müller","email":"dan@example.com","role":"viewer"}]

[{"id":1001,"title":"Bug: login redirects to 404","state":"open","labels":["bug","priority:high"],"user":{"login":"alice"}},{"id":1002,"title":"Feature: dark mode toggle","state":"open","labels":["enhancement"],"user":{"login":"bob"}},{"id":1003,"title":"Docs: update README","state":"closed","labels":["docs","good-first-issue"],"user":{"login":"carol"}}]

[{"_id":{"$oid":"6634a1b2c3d4e5f600000001"},"email":"alice@example.com","metadata":{"signupDate":"2026-01-15T10:30:00Z","preferences":{"newsletter":true,"theme":"dark"}}},{"_id":{"$oid":"6634a1b2c3d4e5f600000002"},"email":"bob@example.com","metadata":{"signupDate":"2026-02-20T14:15:00Z","preferences":{"newsletter":false,"theme":"light"}}}]

{"event":"signup","user":"alice","ts":1715000000}
{"event":"login","user":"alice","ts":1715000060}
{"event":"checkout","user":"alice","ts":1715000300}

[{"id":"ord-001","customer":{"name":"Alice Chen","email":"alice@example.com","address":{"city":"Seattle","country":"US"}},"items":[{"sku":"SKU-100","qty":2},{"sku":"SKU-205","qty":1}]},{"id":"ord-002","customer":{"name":"Bob Garcia","email":"bob@example.com","address":{"city":"Madrid","country":"ES"}},"items":[{"sku":"SKU-100","qty":1}]}]

[{"name":"GET /users returns 200","status":"pass","duration":142},{"name":"POST /users creates record","status":"pass","duration":287},{"name":"GET /users/999 returns 404","status":"fail","duration":98,"error":"Expected 404, got 500"},{"name":"DELETE /users/1 returns 204","status":"pass","duration":156}]

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

1. 1

   الصق بيانات JSON

   أدخل أو الصق JSON في حقل الإدخال أعلاه. تقبل الأداة مصفوفات الكائنات والكائنات المفردة وNDJSON (JSON المحدّد بأسطر) — مع اكتشاف تلقائي. يمكنك أيضاً النقر على «تحميل مثال» لتجربة عينة كاستجابة REST API أو تصدير MongoDB أو سجل أحداث NDJSON.

2. 2

   اختر إعداداً (أو اضبط الخيارات)

   انقر على RFC 4180 (الافتراضي) أو Excel (فاصلة منقوطة EU + BOM) أو TSV (علامة جدولة) أو الأنبوب للوصول إلى الصيغة المستهدفة بنقرة واحدة. افتح لوحة الخيارات للتحكم الدقيق: المحدّد، صف العنوان، الاقتباس (تلقائي/دائماً)، نهاية السطر (LF/CRLF)، BOM، التداخل (تسطيح/تحويل نصي).

3. 3

   انسخ أو حمّل CSV

   انقر على «انسخ» لنقل CSV إلى الحافظة، أو «تحميل» لحفظه كملف .csv (أو .tsv مع إعداد TSV) جاهز لـ Excel أو Google Sheets أو PostgreSQL COPY أو أي خط بيانات. لرحلات الذهاب والعودة، انقر على «تبديل الاتجاه» لتحويل CSV إلى JSON في مكانه.

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

42

[{"value": 42}]

[
  {"name": "GET /users", "status": "pass"},
  {"name": "GET /users/999", "status": "fail", "error": "500"}
]

// Output CSV (note empty cell in row 1)
name,status,error
GET /users,pass,
GET /users/999,fail,500

{"id": 9007199254740993}
// JavaScript reads as 9007199254740992 (precision lost)

{"id": "9007199254740993"}
// CSV preserves the string; Excel displays exactly

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

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

id,name,price
1,Alice,1,234.56
// Excel-EU mis-parses 1,234.56 as two columns

// Excel preset output: ; + CRLF + BOM
id;name;price
1;Alice;1234,56
// Excel-EU reads cleanly with comma decimal

[
  {"event": "signup"},
  {"event": "login"}
]
// Detected as a regular JSON array (works, but not NDJSON path)

{"event": "signup"}
{"event": "login"}
// Each line is one JSON value — auto-detected as NDJSON

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

استجابة API إلى جدول

الصق استجابة REST API (مصفوفة من كائنات المستخدمين/الطلبات/الأحداث) واحصل على CSV جدولي نظيف جاهز لـ Excel أو Google Sheets أو Numbers. الحالة الأكثر شيوعاً — يحتاج المحلّلون ومديرو المنتج بيانات بشكل جدول، ويشحن المهندسون JSON من الواجهة الخلفية.

تصدير MongoDB إلى مستودع البيانات

حوّل إخراج mongoexport JSON (مع غلافات $oid ووثائق بيانات وصفية متداخلة) إلى CSV للتحميل إلى BigQuery أو Snowflake أو Redshift. يحفظ وضع التحويل النصي الشكل المتداخل دون فقدان عندما تدعم الأدوات اللاحقة JSON داخل الخلية.

فرز قضايا GitHub

اسحب القضايا من /repos/{owner}/{repo}/issues، الصق JSON، واحصل على CSV مسطّح بأعمدة id وtitle وstate وlabels وuser.login. أسقطه في Sheets للتصفية والترتيب والإسناد أثناء تخطيط السبرنت.

مراجعة سجل أحداث NDJSON

سجلات البث من Cloud Logging أو Datadog أو Vector أو خطك الخاص غالباً ما تصل كـ NDJSON (.ndjson، .jsonl). الصق محتويات الملف مباشرة — مع اكتشاف تلقائي — واحصل على CSV لتحليل خاص دون إنشاء خط ETL حقيقي.

استخراج طلبات التجارة الإلكترونية

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

تقرير اختبارات Postman/Newman

تصديرات اختبارات Postman تتضمن صفوفاً بأشكال مختلطة (بعضها بحقول error اختيارية). الصق JSON، واحصل على CSV مع توحيد كل المفاتيح وملء الخلايا المفقودة — مثالي لمشاركة تقارير الاختبارات الفاشلة مع غير المهندسين في Sheets.

تفاصيل تقنية

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

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

خوارزمية اكتشاف الأعداد الصحيحة الكبيرة

قبل تمرير JSON عبر JSON.parse() (الذي سيُقرّب الأعداد الصحيحة الكبيرة بصمت عبر IEEE 754)، تُنفّذ الأداة فحص تعبير منتظم على نص JSON الخام بحثاً عن قيم صحيحة خارج النطاق الآمن (-2^53+1 إلى 2^53-1). عند الاكتشاف، تُسجَّل مسارات الحقول المتأثرة ويظهر شريط تحذير «عدد صحيح كبير» أسفل الإخراج. ثم يحفظ كاتب CSV هذه القيم كسلاسل، مما يضمن دقة تامة عبر Excel وGoogle Sheets وأي مستهلك لاحق يدعم النصوص.

BOM وترميز UTF-8 لـ Excel

كل الإدخال والإخراج UTF-8. يُسبق UTF-8 BOM الاختياري (0xEF 0xBB 0xBF) إلى الإخراج عند تفعيل تبديل BOM أو اختيار إعداد Excel. يستخدم Excel على Windows BOM لاكتشاف ترميز UTF-8 — بدونه، يعود Excel إلى لغة النظام (Windows-1252 في الولايات المتحدة، Windows-1251 في روسيا، إلخ.) ويُشوّه الأحرف غير ASCII. المحلّلات الحديثة (Python csv، Pandas، jq، PostgreSQL) عموماً لا تحتاج BOM وقد تُدرجه كحرف ضائع في بداية الخلية الأولى، لذا اترك BOM معطّلاً للخطوط غير Excel.

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

اختر إعداداً قبل ضبط الخيارات

إعدادات RFC 4180 وExcel وTSV والأنبوب تضبط خمسة خيارات دفعة واحدة (المحدّد، نهاية السطر، وضع الاقتباس، BOM، صف العنوان). اختر أقرب إعداد أولاً، ثم اضبط الخيارات الفردية فقط إذا لزم الأمر — هذا يتجنّب الخطأ الشائع بقلب خيار ونسيان آخر (مثلاً، التبديل إلى فاصلة منقوطة لكن إبقاء LF، الذي لا يزال Excel-EU على Windows يُحلّله بشكل خاطئ).

تسطيح للتحليل، تحويل نصي لرحلات الذهاب والعودة

استخدم التسطيح عندما تكون الوجهة Excel أو Sheets أو تحليلاً لمرة واحدة — المفاتيح بنقاط تُنتج أنظف تخطيط جدولي. استخدم التحويل النصي عندما تحتاج رحلة CSV ← JSON ← CSV دون فقدان البيانات — تنجو المصفوفات والكائنات كـ JSON داخل خلية واحدة. التبديل في منتصف التصدير وإعادة التشغيل رخيص؛ اختر بناءً على المستهلك.

استخدم BOM فقط لـ Excel

UTF-8 BOM مطلوب لـ Excel على Windows لاكتشاف الترميز بشكل صحيح. كل محلّل آخر (Python csv، Pandas، jq، PostgreSQL COPY، BigQuery) إما يتجاهل BOM أو يُدرجه كحرف ضائع في بداية الخلية الأولى، مما يكسر أسماء الأعمدة. اترك BOM معطّلاً للخطوط وفعّله (أو استخدم إعداد Excel) فقط عندما تكون الوجهة Excel.

احتفظ بالمعرّفات الكبيرة كسلاسل في JSON

معرّفات سنوفليك في Twitter، ومعرّفات Discord، وحقول MongoDB Long، وresourceVersion في K8s هي أعداد صحيحة 64 بت تتجاوز النطاق الآمن في JavaScript (2^53 - 1). خزّنها كسلاسل JSON ("id": "9007199254740993") قبل التحويل — سيحفظ CSV الأرقام بدقة، بينما القيمة العددية ستُقرَّب بصمت بـ JSON.parse().

تحقق من شكل الصف قبل التحميل

الصفوف بأشكال مختلطة (بعض الكائنات بمفاتيح لا توجد في غيرها) تُدمج مع خلايا فارغة في الإخراج، وتعرض الأداة تحذير «ملاحظات المخطط». للمستهلكين بمخطط صارم (BigQuery، Redshift COPY)، تحقق من أن كل الصفوف تشترك في نفس المفاتيح قبل التصدير — أو تعامل مع القيم المفقودة صراحةً في خطك. استخدم منسّق JSON لفحص شكل المدخل أولاً.

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