مقارنة النصوص واكتشاف الفروقات

ما هي مقارنة النصوص؟

// Two strings that look 'mostly the same' but a naïve check disagrees
const a = 'hello world';
const b = 'hello, world!';

// Character equality
a === b; // false — but only 3 characters actually changed.

// LCS-style diff (this tool, at line + word granularity)
// → 1 line modified, inline highlight: 'hello[, ]world[!]'
// → unified patch:
//   --- original
//   +++ modified
//   @@ -1 +1 @@
//   -hello world
//   +hello, world!

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

أمثلة

function getUser(id) {
  const u = db.users.find(x => x.id === id);
  return u;
}

function getUser(userId) {
  const u = db.users.find(x => x.id === userId);
  return u;
}

1. The service is provided as-is.
2. Either party may terminate with 30 days notice.
3. Disputes are resolved in California courts.

1. The service is provided as-is.
2. Either party may terminate with 30 days notice.
2a. Termination notice must be in writing.
3. Disputes are resolved in California courts.

GET /api/users 200 14ms
POST /api/orders 201 88ms
GET /api/orders/42 200 21ms

GET /api/users 200 14ms
POST /api/orders 201 4200ms
GET /api/orders/42 500 21ms

  margin: 0;  
  padding: 0;
  border: none;

  margin: 0;
  padding: 0;
  border: none;

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

1. 1

   ألصق النسختَين

   النص الأصلي على اليمين، المعدَّل على اليسار. يُعرض الفرق المباشر أثناء الكتابة؛ المدخلات الكبيرة (أكثر من 200 كيلوبايت إجمالًا) تتحوّل إلى زرّ «الفرق» اليدوي.

2. 2

   فعِّل خيارات التجاهل التي تحتاجها

   تجاهل حالة الأحرف، تجاهل كل المسافات، تجاهل المسافات الزائدة، أو تجاهل الأسطر الفارغة — كل منها مستقلّ ومحفوظ بين الزيارات.

3. 3

   اقرأ الفرق أو خذ الرقعة

   «جنبًا إلى جنب» للمراجعة البشرية، Unified لصيغة الرقعة ---/+++/@@. «انسخ unified diff» يضع رقعة نظيفة في حافظتك لمراجعة الكود أو patch -p1.

مزالق شائعة في الفرق

Diff: 200 modifications (all because of trailing \r)

Ignore trailing spaces / tabs → 2 real changes

Diff: 87 modifications (all are indent changes)

Ignore all whitespace → 4 actual changes

Diff: paragraph 2 'completely changed' (one blank line moved)

Ignore blank lines → no changes in paragraph 2

0 differences shown, but `cmp` says the files differ

Disable all Ignore options → real diff appears

Text diff on JSON: 100% of lines changed (just a key reorder)

<a href="/ar/tools/json-diff">JSON Diff</a>: 0 differences

Pasted a 20,000-line log — only first 5,000 lines diffed

`diff -u a.log b.log` in terminal handles full file

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

مقتطف مراجعة كود

ضع نسختَي دالة في الصندوقَين لترى إعادة تسمية أو فرعًا محذوفًا أو شرطًا حارسًا جديدًا في لمحة. إبراز الكلمات داخل السطر أسرع من مسح فرق GitHub لتغيير سطر واحد.

مراجعة عقد أو سياسة باللون الأحمر

ألصق عقد البارحة مقابل مراجعة اليوم. تقفز البنود المُدرَجة إلى البصر؛ تنطوي الفقرات غير المتغيّرة إلى رمادي. صدِّر unified patch لمسار المراجعة القانونية.

التحقيق في الجداول الزمنية للسجلات

قارن شريحة سجلّ ما قبل الحادثة بشريحة أثنائها. يطفو انجراف الكمون ورمز الحالة والتكرار فورًا دون awk.

مراجعة مسوّدة نثر

ألصق مسوّدتك ونسخة المحرّر. يُظهر فرق الكلمات داخل السطر أيّ الجمل أُعيدت كتابتها — ثمين لقبول التغييرات أو رفضها واحدًا واحدًا.

مراجعة ترجمة

قارن ترجمة قديمة بإعادة ترجمة لتأكيد أن النص الجديد يحافظ على المعنى والبنية والعناصر النائبة. فعِّل «تجاهل المسافات الزائدة» لإسكات الضوضاء التي يُدخلها المترجمون عادةً.

تدقيق ملف إعداد أو .env

قارن ملفَّي .env أو docker-compose.yaml أو shell rc. مع تفعيل «تجاهل الأسطر الفارغة»، يركّز الفرق على الفروقات الوظيفية بدلًا من ضوضاء التنسيق.

تفاصيل تقنية

LCS مع تقليم البادئة/الذيل

تُحذف الأسطر القائدة والذيلية المشتركة قبل تشغيل LCS بالبرمجة الديناميكية. فرق «ملفَّي إعداد من 2,000 سطر مع سطر واحد متغيّر» ينطوي إلى جدول 1×1 ويُعرض في أقل من ميلي ثانية.

فرق رمز داخل السطر

تُقرن قطع الحذف+الإضافة المتجاورة وتُرمَّز عبر مقاطع كلمة/غير كلمة/مسافة Unicode. تمريرة LCS ثانية تُنتج امتدادات الرموز الخضراء/الحمراء التي تجعل الأسطر المعدَّلة قابلة للقراءة.

unified diff = متوافق مع git/patch

تتبع المخرجات صيغة ---/+++/@@ -L,C +L,C @@ المعرَّفة لـ GNU patch والمستخدَمة في Git و GitHub وكل أدوات مراجعة الكود. طبِّق بـ pbpaste | patch -p0.

حدّ المدخل عند 5,000 سطر لكل جانب

فوق الحدّ يُقتطع الفرق ويُعرض تحذير. للمدخلات بحجم عدة ميغابايت استخدم سطر الأوامر diff -u أو git diff --no-index — تتدفّق وتتعامل مع غيغابايتات.

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

اختر خيارات التجاهل قبل القراءة

ضوضاء المسافات الزائدة و CRLF وحالة الأحرف تُغرق الإشارة. فعِّل الخيارات الصحيحة أوّلًا؛ يصبح الفرق أسهل قراءةً ولن تدرّب نفسك على تجاوز تغييرات «وهمية».

استخدم Unified للمشاركة، وجنبًا إلى جنب للمراجعة

الأعمدة البصرية لعينَيك. الرقع الموحَّدة لطرفيات الجميع. unified diff منسوخة تنزل في رسالة Slack أو تعليق Jira أو patch -p1 دون ترجمة.

تحقّق من النسبة المئوية للتطابق

لو كان ملفَّان «متطابقَين تقريبًا» لكن نتيجة التشابه 30٪، فلديك مشكلة نهاية أسطر أو مسافات. فعِّل «تجاهل كل المسافات» وأعد الفحص قبل قراءة الفرق.

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