تحويل JSON إلى CSV JavaScript Object Notation ↔ Comma-Separated Values مجاناً عبر الإنترنت آمن
أفلِت ملف JSON وخذ CSV. القراءة والكتابة تجريان هنا، داخل متصفحك، فلا يغادر الملف جهازك — وما يُبقيه العبور وما لا يستطيع مكتوبان أدناه، لا متروكان لتكتشفهما بنفسك.
حوِّل ملفك
أفلِت هنا ملف JSON، أو اختر واحداً.
ملفك لا يغادر هذا الجهاز. كل شيء يعمل داخل متصفحك.
لا رفع لأي ملف
التحويل من JSON
التحويل إلى JSON
من أين جاءت هذه الصيغ
صيغةُ CSV أقدمها وأقلّها تقييساً: جدولٌ مكتوبٌ سطوراً من نص، استُعمل منذ السبعينيات ولم يُوصَف كتابةً إلا سنة 2005، وقد كان كل برنامجٍ قد قرّر لنفسه ما الفاصل ومتى تُوضَع علامات الاقتباس. وخرج XML من SGML سنة 1998، للمستندات التي يجب أن تحمل بنيةً صارمة وأن تُراجَع على مخطّط. وانتزع دوغلاس كروكفورد صيغةَ JSON من جافاسكربت نحو سنة 2001، وقد جُرِّدت عمداً إلى كائناتٍ وقوائمَ وأعدادٍ وسلاسلِ حروف — وهذا التجريد هو سبب استيلائها على الوِب. وYAML ابنُ عمها المقروء، حيث تقوم الإزاحةُ بما تقوم به الأقواس في غيرها. والذي يهم في التحويل بينها شيءٌ واحد: CSV مسطحة، شبكةٌ من صفوفٍ وأعمدة، أما JSON وXML وYAML فأشجار.
أين تصادفها
صيغة CSV هي ما يُصدّره جدول الحساب، وما يناولك إياه محاسبٌ أو منصةُ متجرٍ أو كشفُ حساب. وJSON هي ما تتكلم به خدماتُ الوِب، وبها تُكتَب ملفاتُ الإعداد أكثر فأكثر. وXML تعيش في أنظمة المؤسسات الأقدم، وفي معايير الفوترة، وفي داخل صيغ المكاتب نفسها. وYAML حيث يكتب البشرُ الإعداداتِ بأيديهم. والتحويلُ بينها هو عملُ كل يوم: نقلُ البيانات من حيث نشأت إلى حيث تُطلَب.
أسئلة متكررة
فُتح ملف CSV عندي في إكسل عموداً واحداً. لماذا؟
لأن جدول الحساب كان ينتظر فاصلاً آخر. فإكسل يتبع فاصلَ القوائم في إعدادات المنطقة، وهو الفاصلةُ المنقوطة في كل موضعٍ تكون فيه الفاصلةُ علامةً عشرية أصلاً — أي في معظم أوروبا القارية. فيبدو الملفُّ المفصولُ بالفواصل عمودَ نصٍّ واحداً. استعمل نافذة الاستيراد وصرِّح بالفاصل، بدل أن تفتح الملف بنقرتين. وبالإعداد الإقليمي نفسه يُفسَّر وصولُ 3.5 أحياناً على هيئة تاريخ.
لماذا لا يصير ملف JSON المتداخل عندي جدولاً مرتباً؟
لأن جدول الحساب مسطح وJSON شجرة. فالصفُّ يحمل قيمةً واحدة لكل عمود؛ وكائنُ JSON قد يحمل قائمةً داخل حقلٍ داخل قائمةٍ أخرى. والتحويل يعني اختيارَ كيفية تسطيح ذلك: إما وصلُ الأسماء المتداخلة في عنوان عمودٍ واحدٍ طويل، وإما تكرارُ الصف الأب مرةً لكل ابن. وكلاهما تنازل، ولا يمكن نقضُ أيٍّ منهما تلقائياً — ولهذا يحتاج الرجوعُ من الجدول إلى الشكل الأصلي قراراً بشرياً في الغالب.
أيفقد الملف شيئاً من جودته؟
ذلك بحسب ما يسع الصيغتين أن تحملاه. فالتحويل بين صيغتين تحفظان الشيء نفسه — من PNG إلى BMP، ومن WAV إلى FLAC — لا يفقد شيئاً. أما التحويل إلى صيغةٍ تطرح المعلومات توفيراً للمساحة، كـJPEG أو MP3، فيفقد قليلاً في كل مرة، والعودة لا تردّ ما ذهب. وحيث يوجد خيار، تميل هذه الصفحة إلى حفظ الجودة الأصلية لا إلى إخراج أصغر ملف.
هل يُرفَع ملفي إلى مكانٍ ما؟
لا. يجري التحويل داخل متصفحك، على جهازك أنت؛ فالملف لا يغادره قط، وليس هنا خادمٌ أصلاً يستقبله. ولهذا كان الذي يحدّ الملفَّ الكبير ذاكرتَك أنت لا عمليةَ رفع، ولهذا لا يمكن لشيءٍ تحوّله أن يظهر في سجلات أحد — ولا في سجلاتنا. أما أدوات الصوت والصورة فتجلب محرّك التحويل من هذا الموقع في أول استعمال — نحو ثلاثين ميغابايت، مرةً واحدة؛ وبعدها يبقى العمل كلّه على جهازك.
لماذا يحوّل الناس JSON إلى CSV
JSON هي اللغة التي تتخاطب بها البرامج. تصدير من خدمة ويب، وجواب واجهة برمجية، وإعداد حفظه تطبيق، وتفريغ من قاعدة بيانات: معظمها يصل بصيغة JSON. وهي رائعة للبرمجيات ومربكة للناس، لأن شاشة مليئة بالأقواس وعلامات الاقتباس والفواصل لا يمكنك فرزها أو تصفيتها أو جمعها. أما CSV فهي العكس: جدول بسيط، صف في كل سطر، وخلايا تفصل بينها فواصل، ويُفتح في كل جدول بيانات على وجه الأرض. ولهذا يحوّل الناس JSON إلى CSV: لديهم بيانات أنتجها برنامج ويريدون النظر إليها أو عدّها أو تسليمها إلى من يعيش في جدول بيانات.
والمواقف مألوفة. محلل سحب سجلات من واجهة برمجية ويريد جدولاً محورياً. وصاحب متجر صدّر طلبات من منصة إلكترونية ويحتاج إليها في إكسل. وباحث لديه نتائج استبيان حفظتها أداة. ومطوّر يريد فحص بضع مئات من السجلات بنظرة. وفي كل حالة تكون البيانات منظَّمة أصلاً، والمفقود هو الجدول فقط.
تحوّل هذه الصفحة JSON إلى CSV داخل متصفحك. يُقرأ ملفك ويُكتب هنا، فلا يغادر جهازك، وهذا مهم لقوائم العملاء والطلبات وكل ما هو شخصي. وتخبرك الصفحة مقدماً بما يبقيه العبور وما لا يستطيعه، بدلاً من تركك لتكتشفه. وستجد أدناه كيف يعمل التحويل، وأي نوع من JSON يمكن أن يصير جدولاً، وماذا يحدث لما سواه.
كيف يعمل التحويل
تصير المفاتيح الترويسة، بالترتيب الذي ظهرت به أولاً
يُقرأ ملف JSON داخل متصفحك. تصير مفاتيح السجلات صف الترويسة في CSV، بالترتيب الذي ظهرت به أولاً. ثم يصير كل سجل صفاً، وتُكتب كل قيمة كما هي. وإن نظرت إلى السطر الأول من النتيجة رأيت أسماء الحقول؛ وتحتها سطراً لكل سجل.
المفتاح المفقود يترك خلية فارغة
السجلات ليست موحدة دائماً. فقد ينقص أحدها حقل تملكه الأخرى. وفي هذه الحالة يترك الصف الذي ينقصه مفتاح خلية فارغة بدلاً من إزاحة الأعمدة. ويبقى العمود في مكانه، وتكون الخلية فارغة ببساطة، فيظل الجدول متراصاً.
كل صف وكل عمود
لا شيء يُسقط. يصير كل سجل صفاً ويصير كل مفتاح يظهر في أي مكان عموداً. ولا حاجة إلى القلق من أن حقلاً يظهر في السجل الألف فقط سيُترك.
ما الذي يُحتفظ به
كل الصفوف وكل الأعمدة
يُحتفظ بكل صف وكل عمود. والبيانات التي أعطيتها هي البيانات التي تحصل عليها، بشكل جدول.
القيم كما هي
تُكتب كل قيمة كما هي. تبقى الأرقام أرقاماً والنصوص نصوصاً، وتوضع القيم التي تحتوي فواصل أو علامات اقتباس بين علامات اقتباس بشكل صحيح حتى يقرأها جدول البيانات خليةً واحدة.
ترتيب الحقول
تتبع الأعمدة الترتيب الذي ظهرت به المفاتيح أولاً، وهو عادةً الترتيب الذي استعمله البرنامج الذي أنتج الملف. وهذا يبقي الجدول مألوفاً لكل من رأى البيانات بشكلها الأصلي.
ما ينبغي أن تعرفه قبل تحويل JSON إلى CSV
شكل واحد فقط من JSON هو جدول أصلاً
شكل واحد فقط من JSON هو جدول أصلاً: مصفوفة من كائنات مسطحة، مثل قائمة سجلات لكل منها النوع نفسه من الحقول. أما كائن مفرد، أو شجرة فيها كائنات داخل كائنات، فليس فيه صفوف لتُكتب ويُرفض بدلاً من أن يُسطَّح إلى شيء لم تطلبه. وهذا اختيار مقصود. فتسطيح شجرة ينطوي على قرارات بشأن الأسماء وبشأن أي الفروع تبقى، وتخمين خاطئ سينتج جدولاً يبدو صحيحاً وليس كذلك.
القيم المتداخلة تُكتب نص JSON
حيث تكون قيمة ما نفسها قائمة أو كائناً تُكتب في الخلية نص JSON، لأن الخلية لا تستطيع حمل فرع. فسجل له حقل للوسوم، يحمل قائمة، سيعرض تلك القائمة نصاً في خلية واحدة. وهي كلها هناك، وتستطيع تقسيمها بأدوات جدول بياناتك إن شئت.
CSV بلا أنواع
ملف CSV نص. وهل 007 رقم أم رمز أمر يقرره جدول البيانات حين يفتح الملف، وجداول البيانات مشهورة بالتخمين الخاطئ. وقد تتغير الأصفار البادئة والأرقام الطويلة والتواريخ عند الفتح. وإن كان هذا يهمك فاستورد الملف باستعمال مربع حوار الاستيراد وعلّم هذه الأعمدة نصاً.
كيف تحوّل JSON إلى CSV هنا
أضف ملفك
أسقط ملف JSON على الصفحة أو اخترها من جهازك. يُقرأ داخل متصفحك ولا يُرفع.
حوّل
اضغط الزر. يستغرق ملف بحجم عادي لحظة. أبقِ الصفحة مفتوحة حتى ينتهي.
نزّل وافتح
نزّل CSV وافتحه في برنامج جدول البيانات، أو في محرر نصوص لتنظر إليه. افحص الترويسة وبضعة صفوف في المنتصف والصف الأخير.
نظرة أقرب إلى JSON وCSV
الأشجار والجداول
JSON تصف شجرة: كائنات تحتوي قيماً، قد تكون بدورها كائنات أو قوائم. وCSV تصف جدولاً: صفوفاً وأعمدة، لا أكثر. والشجرة تستطيع حمل أشياء لا يستطيعها الجدول، مثل فرع تحته فروع مختلفة. أما الجدول الذي هو قائمة سجلات موحدة فيمكن كتابته بصيغة JSON دون أي فقد. وتحويل JSON إلى CSV هو الانتقال من الشكل العام إلى الخاص، وهو يسير بسلاسة حين تكون البيانات جدولاً في الحقيقة منذ البداية.
لماذا تفيد الصرامة
كثيراً ما تخترع الأدوات التي تقبل أي JSON وتسطّحه تلقائياً أسماء أعمدة مثل address.street أو items.0.price. وهذا مريح إلى أن تحتاج إلى معرفة ما حدث. وبقبول الشكل الذي هو جدول أصلاً فقط، تعفيك هذه الصفحة من القرارات الصامتة. فإن كان ملفك شجرة عرفت ذلك فوراً.
الفواصل وعلامات الاقتباس وفواصل الأسطر
لـCSV فخاخها: فاصلة داخل قيمة، وعلامة اقتباس، وفاصل سطر في وسط خلية. وتُعالج بوضع الخلية بين علامتي اقتباس ومضاعفة علامات الاقتباس داخلها، فيقرأ جدول البيانات الجدول كما أُريد له.
حالات شائعة بالتفصيل
تصديرات من خدمات الويب والواجهات البرمجية
تعيد أغلب الخدمات قوائم سجلات بصيغة JSON. وإن احتجت إليها في جدول بيانات فحوّل JSON إلى CSV وافتح النتيجة. إنه أسرع طريق من جواب واجهة برمجية إلى جدول محوري.
الطلبات والعملاء والمنتجات
كثيراً ما تتيح منصات المتاجر تصدير البيانات بصيغة JSON. وCSV للطلبات أو المنتجات يمكن فرزه بالتاريخ أو تصفيته بالعميل أو جمعه بالمنتج ببضع نقرات.
نتائج الاستبيانات والسجلات
الأدوات التي تخزّن إجابات الاستبيانات أو سجلات الأحداث بصيغة JSON تنتج سجلاً لكل إجابة أو حدث. وبصيغة CSV يمكن عدّها ورسمها ومقارنتها.
فحص البيانات بنظرة
كثيراً ما يحوّل المطورون بضع مئات من السجلات إلى CSV لمجرد قراءتها. والجدول أسهل في المسح من الأقواس المتداخلة، ويستطيع جدول البيانات الفرز وإبراز الشاذ.
نصائح عملية قبل تحويل JSON إلى CSV
افحص شكل ملفك
افتح JSON في محرر نصوص. فإن بدأ بقوس مربع وحمل قائمة سجلات بأقواس معقوفة بقيم بسيطة فهو الشكل الصحيح. وإن بدأ بقوس معقوف وفيه سجلات متداخلة فابحث عن القائمة التي تحتاج إليها واستخرجها أولاً.
اعرف أي القيم متداخلة
إن احتوت بعض الحقول قوائم أو كائنات فستظهر نص JSON في خلاياها. قرر هل تحتاج إلى تقسيمها، وخطط لذلك في جدول البيانات.
انتبه إلى الترميز والفاصل
يُكتب CSV بفواصل. وتتوقع بعض جداول البيانات في بعض المناطق فواصل منقوطة. فإن فُتح ملف كعمود واحد فاستعمل وظيفة الاستيراد واضبط الفاصل.
الملفات الكبيرة
كل شيء يعمل على جهازك، فالملف الكبير جداً يحتاج إلى ذاكرة. ولملفات من عدة ميغابايتات استعمل حاسوباً، وقسّم البيانات إن عانت الصفحة.
أسئلة يطرحها الناس قبل التحويل
لماذا رُفض ملفي؟
لأنه ليس مصفوفة كائنات مسطحة. فكائن مفرد، أو شجرة فيها كائنات داخل كائنات، ليس فيه صفوف لتُكتب. اختر القائمة التي تحتاج إليها وحوّلها.
ماذا يحدث لسجل ينقصه حقل؟
يترك خلية فارغة في ذلك العمود. ولا تُزاح الأعمدة.
ماذا يحدث للقوائم داخل سجل؟
تُكتب في الخلية نص JSON، لأن الخلية لا تستطيع حمل فرع.
لماذا تختفي الأصفار البادئة عندي في جدول البيانات؟
لأن جدول البيانات قرر أن العمود رقمي حين فتح الملف. وCSV يحتفظ بالأصفار؛ فاستعمل مربع حوار الاستيراد وعلّم العمود نصاً.
هل يُرفع ملفي؟
لا. يعمل التحويل في متصفحك ولا يغادر الملف جهازك.
هل أستطيع العودة إلى JSON؟
نعم. CSV إلى JSON يعيد الجدول قائمة سجلات.
الاختيار الحكيم حين تحوّل JSON إلى CSV
CSV أم جدول بيانات حقيقي؟
إن أردت ملفاً يُفتح في إكسل بورقة سليمة فإن JSON إلى XLSX يكتب الجدول نفسه مصنفاً. وCSV أخف وأعم؛ وXLSX يُفتح دون خطوة استيراد.
أهداف أخرى
إن كانت الوجهة ملف إعدادات أو ترميز فإن JSON إلى XML وJSON إلى YAML يخدمان هذه الحاجات.
احتفظ بـJSON
JSON هو الأصل. فهو يحمل البنية والأنواع. احتفظ به، وعامل CSV على أنه عرض للبيانات.
الحصول على نتيجة جيدة بعد التحويل
استورد، لا تفتح فقط
حين يحتوي ملف رموزاً أو أرقام هواتف أو تواريخ فاستعمل مربع حوار الاستيراد في جدول بياناتك واضبط نوع كل عمود. فهذا يتجنب الضرر الصامت الذي قد يسببه التخمين التلقائي.
افحص بضعة صفوف مقابل المصدر
قارن سجلين أو ثلاثة في الجدول بـJSON. يستغرق دقيقة ويخبرك أن الجدول أمين.
قسّم الخلايا المتداخلة عند الحاجة
إن حملت خلية قائمة نصاً فاستعمل أداة تحويل النص إلى أعمدة أو صيغة لتقسيمها. أو ارجع وجهّز JSON بحيث يكون لكل عنصر سجل خاص به.
تجهيز JSON ليتحول جيداً
شكّل البيانات قبل أن تحوّل JSON إلى CSV
إن كان ملفك شجرة فتستطيع عادةً إعادة تشكيلها إلى قائمة سجلات مسطحة قبل أن تحوّل JSON إلى CSV. اختر القائمة التي تحمل ما تريد عدّه: الطلبات أو العملاء أو الأحداث. انسخها إلى ملف خاص بها، مع الأقواس المربعة حولها، وستقبلها الصفحة. وهذه الخطوة الصغيرة هي الفرق بين رفض وجدول نظيف.
أبقِ أسماء الحقول ذات معنى
تصير المفاتيح الترويسة، فكلما كانت الأسماء أوضح كان الجدول أقرأ. وإن كنت تتحكم في المصدر فاستعمل أسماء مثل order_date وcustomer_name بدلاً من اختصارات لا يفهمها إلا مبرمج.
كن متسقاً في الأنواع
حقل يحمل أرقاماً في معظم السجلات ونصاً في قليل منها سيربك جدول بيانات. فإن استطعت نظّف الشاذ قبل التحويل، حتى يعني كل عمود شيئاً واحداً.
فكّر في التواريخ
التواريخ في JSON عادةً نص بصيغة متفق عليها. وتُكتب في CSV كما هي. وبعد أن تحوّل JSON إلى CSV أخبر جدول البيانات كيف يقرؤها عند الاستيراد، وسيعاملها تواريخ ويتيح لك الفرز والتصفية بالزمن.
اختبر على قطعة صغيرة أولاً
إن كان ملفك كبيراً فانسخ أول عشرين سجلاً إلى ملف اختبار وحوّله. ونظرة سريعة إلى النتيجة تبيّن هل الشكل وأسماء الحقول كما تتوقع، قبل أن تنفق وقتاً على الشيء كله.
الخصوصية والتعامل
لماذا يهم التحويل المحلي للبيانات
كثيراً ما تحوي ملفات البيانات ما هو خاص: عملاء وطلبات وعناوين ورسائل. وكثير من المحوّلات عبر الإنترنت يرفع ملفك إلى خادم ويعالجه ويعيد النتيجة، ولبعض الوقت تعيش نسخة على جهاز لا تتحكم فيه. أما هنا فمتصفحك أنت يؤدي العمل، فتبقى البيانات على جهازك.
ماذا يحدث حين تغادر
حين تغلق الصفحة يختفي الملف المحوّل من المتصفح، فنزّله أولاً. ولا يُحتفظ بشيء من بياناتك.
إن حدث خطأ ما
تقول الصفحة إن الملف ليس JSON صالحاً
قد توجد فاصلة شاردة أو علامة اقتباس ناقصة أو قوس لا يُغلق. افتح الملف في محرر يبرز أخطاء JSON وأصلح السطر الذي يشير إليه.
تبدو الأعمدة مبعثرة
قد يتوقع جدول بياناتك فاصلاً مختلفاً. استورد الملف واضبط الفاصل على فاصلة.
تتجمد الصفحة مع ملف كبير
كل شيء يعمل على جهازك، والملف الكبير يحتاج إلى ذاكرة. حاول مجدداً على حاسوب، أو قسّم البيانات.
أدوات ذات صلة
تغطي العائلة نفسها من الأدوات المهام المجاورة. وللعودة استعمل CSV إلى JSON. ولمصنف فإن JSON إلى XLSX وXLSX إلى JSON تعملان مع ملفات إكسل. ولصيغ أخرى من البيانات المنظمة هناك JSON إلى XML وXML إلى JSON وJSON إلى YAML وYAML إلى JSON. وحين تكون الأرقام في ملف PDF فإن PDF إلى XLS يعيد بناء جدول من الصفحة.
مثال محلول
لنفترض أنك صدّرت 500 طلب من متجر إلكتروني في ملف JSON، وتريد أن تعرف أي المنتجات تباع أكثر. تسقط الملف هنا وتضغط الزر. وبعد لحظة تنزّل CSV بترويسة من أسماء الحقول و500 صف تحتها. وتستورده في جدول بياناتك، وتعلّم رمز المنتج نصاً، وتصنع جدولاً محورياً وترى الجواب. ويبقى JSON في مجلدك مصدراً.
قائمة فحص قصيرة
قبل التحويل
تأكد من أن الملف قائمة سجلات. وسجّل أي الحقول متداخلة. واحتفظ بـJSON.
أثناء التحويل
ابقَ في الصفحة حتى يجهز الملف.
بعد التحويل
استورد CSV بالأنواع الصحيحة، وافحص بضعة صفوف مقابل المصدر، واحفظ الجدول بصيغة جدول بياناتك.
أخطاء شائعة
تغذيته بشجرة
لا تتوقع أن تحوّل JSON إلى CSV لملف شديد التداخل. استخرج قائمة السجلات أولاً.
الفتح بنقرة مزدوجة والثقة بالنتيجة
تخمّن جداول البيانات الأنواع. استورد بأنواع صريحة للرموز والتواريخ.
حذف JSON
احتفظ به. فهو يحمل البنية التي لا يستطيعها الجدول.
بياناتك تبقى على جهازك
يحدث التحويل محلياً. يقرأ متصفحك أنت ملفك ويعيد كتابته هناك ويعيده إليك بصيغة CSV. لا شيء يُرفع، فلا تنتهي نسخة على خادم ولا يستطيع أحد آخر قراءتها. ولبيانات ذات محتوى خاص هذه هي الطريقة الآمنة لتحويل JSON إلى CSV.
الخلاصة
لتحوّل JSON إلى CSV هنا، أسقط الملف واضغط الزر. يُقرأ ويُكتب في متصفحك، فلا يغادر الملف جهازك. يُحتفظ بكل صف وكل عمود: تصير المفاتيح الترويسة، بالترتيب الذي ظهرت به أولاً، وتُكتب كل قيمة كما هي. والصف الذي ينقصه مفتاح يترك خلية فارغة بدلاً من إزاحة الأعمدة. وشكل واحد فقط من JSON هو جدول أصلاً، مصفوفة من كائنات مسطحة. أما كائن مفرد، أو شجرة فيها كائنات داخل كائنات، فليس فيه صفوف لتُكتب ويُرفض بدلاً من أن يُسطَّح إلى شيء لم تطلبه. وحيث تكون قيمة ما نفسها قائمة أو كائناً تُكتب في الخلية نص JSON، لأن الخلية لا تستطيع حمل فرع.