يرسل فريق العمليات طلبًا وصفه يحتوي على فاصلة وسطر جديد. الملف المفتوح كمحرر نصوص يبدو كأنه ثلاثة سجلات بينما يقرأ برنامج CSV السطرين كحقل واحد. اختبار التصدير بعدّ أسطر الملف قد يعطي نتيجة خاطئة؛ عدّ السجلات بأداة CSV واختبر النص بعد إعادة قراءته.
اترك إنشاء الحدود لمكتبة CSV
افتح الملف بترميز معلن وnewline="" حتى تدير المكتبة فواصل الأسطر والاقتباس. لا تجمع الحقول بفاصلة داخل سلسلة. جهّز رأس الأعمدة بصيغة يعرفها المستهلك، ثم اكتب سجلًا ببيانات تحمل فاصلة واقتباسًا وسطرًا جديدًا.
import csv
notes = 'العنوان، فرع 2\nملاحظة: "باب جانبي"'
data = [["order_id", "notes"], ["17", notes]]
options = dict(encoding="utf-8", newline="")
with open("orders.csv", "w", **options) as f: csv.writer(f).writerows(data)
with open("orders.csv", **options) as f: rows = list(csv.DictReader(f))
assert rows == [{"order_id": "17", "notes": notes}]
عقد مع قارئ الملف
قارئ CSV يرجع الحقول نصوصًا هنا؛ لو يحتاج النظام معرّفًا رقميًا، حوّله عند الاستيراد وفق قاعدة التحقق المتفق عليها. جرّب فراغًا مقصودًا وحرف اقتباس واقتباسًا متبوعًا بسطر جديد. إذا كان المستهلك برنامج جداول، اختبر النتيجة فيه أيضًا لأن اكتشاف الترميز والفاصل قد يختلف عن قراءة Python.
دليل قبول يصلح للتسليم
احفظ مثال الإدخال وملف الاختبار وتوقع حقل الوصف بالضبط. افحص أن زر التصدير والفلاتر يحددان نفس عدد الطلبات المقروء بعد الاستيراد. اختبر الصفوف دون وصف والتصدير برأس أعمدة فقط. الاقتباس الصحيح يحفظ الحدود داخل CSV؛ وإذا استُخدم الملف في برنامج جداول، فمراجعة تفسير الحقول كصيغ خطوة مستقلة عن سلامة فواصل الأسطر.
المصدر
للاطلاع على خدمات فايندو المرتبطة بهذا المثال: تطوير أنظمة تخطيط الموارد. الغلاف رسم تقني أصلي لبيانات تعليمية.




