أداة مطابقة ملفات

كيف تعمل المقارنة

يقارن هذا الأداة النصين سطرًا بسطر في تمريرة واحدة. يُعتبر السطر معدَّلًا عندما يختلف المحتوى في الموضع نفسه على الجانبين. لا يوجد وضع عرض للاختيار: الجدول الجانبي المتوازي هو النتيجة نفسها.

• الأسطر الرمادية أسطر متطابقة على الجانبين.
• الأسطر الخضراء موجودة فقط في النص المعدَّل.
• الأسطر الحمراء موجودة فقط في النص الأصلي.
• الأسطر البرتقالية موجودة في النصين ولكنها مختلفة.

ولأن المقارنة تعتمد على الموضع، فإن إدراج كتلة من الأسطر يزيح كل ما تحتها، ويُبلَّغ عن تلك الأسطر على أنها معدَّلة.

تجاهل ما لا يهم

توفر الأداة خيارين للتركيز على المقارنة:

• تجاهل المسافات: لن تظهر التغييرات الشكلية فقط.
• تجاهل حالة الأحرف: مفيد لمفردات SQL أو مفاتيح الإعدادات.

الخوارزمية

تتم المقارنة في تمريرة واحدة، فتظهر النتائج فورًا تقريبًا حتى مع الملفات الكبيرة. لا تحاول الأداة البحث عن أطول تسلسل فرعي مشترك كما يفعل git diff؛ فإذا أضفت محتوى في بداية ملفين، سيُبلَّغ عن باقي الملف على أنه معدَّل.

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

• مراجعة الكود قبل فتح طلب سحب (PR)، للتأكد من التغييرات التي أجريتها فعلًا.
• التحقق من الإعدادات بين ملفي بيئتي الاختبار والإنتاج.
• مراجعة المحتوى بين المسودة والمقال النهائي.
• مقارنة التراخيص عند إصدار التبعيات الخارجية ملفات ترخيص جديدة.
• مطابقة البيانات بين تصديرين بصيغة CSV من نظامين مختلفين.

الأخطاء الشائعة

• مقارنة ملفين مصغَّرين (minified)؛ كلاهما سطر واحد، فيُبلَّغ عن كل التغييرات على أنها “تعديل السطر بالكامل”. نسِّق الجانبين قبل اللصق.
• مقارنة ملفات ذات نهايات أسطر مختلفة؛ تُقارَن CRLF وLF كأحرف حرفية، فيظهر كل سطر معدَّلًا. وحِّد نهايات الأسطر قبل اللصق.
• الخلط بين الاختلافات المتعلقة بالمسافات فقط والتغييرات المنطقية؛ استخدم خيار “تجاهل المسافات” عندما يعيد زميل تنسيق ملف.