השוואת טקסטים / Diff Checker

מה זה diff checker?

Diff checker משווה בין שני קטעי טקסט או קוד ומדגיש מה נוסף, מה נמחק ומה השתנה. מפתחים משתמשים ב-diff כל הזמן: בסקירת קוד, בדיבוג שינויי הגדרות, בהשוואת תגובות API, באימות מיגרציות ובהבנת עריכות לפני commit.

קריאת diff היא מיומנות בסיסית של מפתחים. היא מפרידה בין *שינויי התנהגות אמיתיים* לבין שינויי עיצוב לא מזיקים, ועוזרת לזהות את התו האחד שהשתנה בבלוק של 200 שורות. ברגע שמתרגלים לקצב של ירוק / אדום / צהוב, סקירת קוד נעשית מהירה בהרבה.

שני סוגי diff חשובים במיוחד: *diff לפי שורה* (אילו שורות השתנו) ו-*diff לפי מילה* או *לפי תו* (מה השתנה בתוך השורה). כלי diff טוב מאפשר לעבור ביניהם, לפי מה שאתם משווים: קוד מקור או פסקאות טקסט.

מה תלמדו תוך כדי השוואת טקסטים

• diff לפי שורה מראה *איפה* היו שינויים. diff לפי מילה ולפי תו מראה *מה* השתנה בתוך השורה.
• רווחים יכולים להיות משמעותיים (Markdown, YAML, Python) או לא מזיקים (רוב הקוד האחר). הפעילו או כבו את האפשרות להתעלם מרווחים בהתאם.
• diff שנראה קטן יכול להשפיע מאוד אם הוא משנה ערך, תנאי, נתיב, משתנה סביבה או feature flag.
• כששני בלוקים גדולים שונים מאוד זה מזה, מיינו או נרמלו אותם קודם. השוואה של שני אובייקטי JSON לא ממוינים עלולה להציף אתכם בהבדלים שאינם אמיתיים.

איך להשוות שני טקסטים, צעד אחר צעד

1. 1

   הדביקו את שתי הגרסאות

   שימו את הטקסט המקורי בצד שמאל ואת הגרסה החדשה בצד ימין. קוד, JSON, טקסט רגיל, קובצי הגדרות: הכול עובד.

2. 2

   בחרו diff לפי שורה או לפי מילה

   השתמשו ב-diff לפי שורה לקוד מקור או לנתונים מובנים. עברו ל-diff לפי מילה כשמשווים פסקאות טקסט, שבהן הניסוח הוא מה שחשוב.

3. 3

   הגדירו רגישות לרווחים ולאותיות גדולות

   הפעילו *התעלמות מרווחים* אם חשובים לכם רק שינויים משמעותיים, והפעילו *התעלמות מאותיות גדולות/קטנות* כשמשווים לוגים או טקסט שבו הכתיב של האותיות לא חשוב.

4. 4

   קראו את הפלט הצבעוני

   תוכן שנמחק מופיע באדום בצד שמאל, ותוכן שנוסף מופיע בירוק בצד ימין. שורות ששונו מופיעות לרוב כזוג, אחת מכל צד.

5. 5

   המשיכו לשפר

   ערכו אחד הצדדים וצפו ב-diff מתעדכן בזמן אמת. זה מצוין להכנת patch נקי לפני פתיחת pull request.

טבלת עזר לצבעים ולסימנים ב-diff

המוסכמות שה-diff checker של Coddy משתמש בהן, וגם git diff, GitHub ורוב כלי ה-diff האחרים.

דוגמאות diff לנסות

API_TIMEOUT=3000

API_TIMEOUT=30000

{  "id": 42,  "status": "draft",  "published": false}

{  "id": 42,  "status": "published",  "published": true}

function total(items) {  let sum = 0;  for (const i of items) sum += i.price;  return sum;}

function total(items) {  return items.reduce((sum, i) => sum + i.price, 0);}

@@ -1,4 +1,4 @@ function greet(name) {-  return 'Hi ' + name;+  return `Hi ${name}`; }

טעויות diff נפוצות

• התעלמות מרווחים כשהם משמעותיים: Markdown, YAML ו-Python כולן רגישות להזחה.
• סקירה של השורות הירוקות (שנוספו) בלבד ופספוס של שורות אדומות (שנמחקו) חשובות.
• הנחה ש-diff נקי מוכיח שהגרסה החדשה נכונה. diff מראה רק *מה השתנה*, לא *אם השינוי נכון*.
• השוואה של JSON מכווץ או קוד מעוצב בלי לנרמל קודם את אחד הקלטים. כל שורה תיראה שונה גם אם הנתונים זהים.
• הסתמכות על diff של זה לצד זה בקבצים ארוכים מאוד בלי לחפש מילות מפתח מסוימות. השתמשו בשניהם: סרקו קודם, ואז Ctrl+F לשדה שחשוב לכם.

שאלות נפוצות על Diff Checker