לקוח WP Adminify שלח לי פעם שני יצוא של הגדרות התוסף שלו - " לפני העדכון, הכל עבד; לאחר מכן, תפריט הניהול שבור שום דבר אחר לא השתנה." שני כתמי JSON, כל אחד בערך 340 שורות קראתי אותם זה לצד זה, פעמיים, והסכמתי איתו בביטחון: זהה שום דבר לא השתנה חייב להיות הבאג שלנו.
זה היה 't. כשסוף סוף הפסקתי לסמוך על העיניים שלי והבדלתי את שני הקבצים, שם זה היה בשורה 217: מפתח תפקיד בתפריט נעלם "administrator" ל "administrator "- עם חלל נגרר. דמות אחת בלתי נראית. קראתי על פניו באופן אישי פעמיים, כי עיניים אנושיות עושות 't משווים מחרוזות; הם תואמים צורות, ו administrator ו administrator בעלי אותה צורה.
כרטיס התמיכה הזה שינה לצמיתות את הכלל שלי: אם שני טקסטים ארוכים מעשר שורות בערך, אני עושה 't להשוות אותם על ידי קריאה. אי פעם. לאלגוריתם הבדל אין קיצורי דרך התואמים דפוסים להטעות - הוא משווה כל תו ומדווח בדיוק מה שונה. ה כלי Text Diff ב-Toolz.dev עושה זאת בדפדפן שלך, מה שאומר שקונפיגורציות של לקוחות, חוזים וקוד שלא פורסם לעולם לא עוזבים את המחשב שלך. Here' איך הבדל עובד בפועל וכיצד להשתמש בו היטב.
TL;DR: לעולם אל תשווה חזותית טקסטים ארוכים מכמה שורות - העיניים מחמיצות רווחים נגררים, ספרות מוחלפות ועריכות של מילה אחת. הדבק את שתי הגרסאות לתוך כלי Text Diff: ירוק = נוסף, אדום = הוסר, מחושב על ידי אותה משפחת אלגוריתמים של מאיירס שפועלת
git diff. להשתמש מצב קו עבור קוד ותצורת, מצב מילה לפרוזה וחוזים לנתונים מובנים, ה JSON Diff משווה לפי משמעות במקום לפי טקסט הכל רץ צד לקוח.
איך בעצם עובד אלגוריתם הבדל?
רעיון הליבה: למצוא את רצף המשנה המשותף הארוך ביותר (LCS) של שני הטקסטים - הרצף הארוך ביותר של שורות (או מילים, או תווים) המופיע בשניהם, באותו סדר הכל ב-LCS הוא "unchanged." Whatever's שנותר בגרסה A הוא מחיקה; whatever's שנותר בגרסה B הוא תוספת.A "modified" שורה היא רק מחיקה ותוספת שבמקרה יושבות זו ליד זו.
הדרך הסטנדרטית לחשב זאת ביעילות מגיעה מ- Eugene Myers' מאמר משנת 1986, " אלגוריתם הבדל O (ND) והווריאציות והמרכאות שלו;. החלק האלגנטי הוא מה שהמורכבות הכרוכה אומרת: N הוא גודל הקלט, אבל ד האם ה מספר הבדלים. שני טקסטים כמעט זהים נבדלים כמעט באופן מיידי לא משנה כמה זמן הם, כי האלגוריתם 's עובדים בקנה מידה עם כמה הם שונים, לא רק כמה גדולים. That's מדוע הבדל של שתי תצורות של 300 שורות הנבדלות בשורה אחת מרגיש מיידי - האלגוריתם לא עושה כמעט כלום, וזה בדיוק המצב שבו העיניים שלך עושות הכי הרבה עבודה ונכשלות.
אותה משפחת אלגוריתמים היא מנוע ברירת המחדל git diff, גנו diff, ורוב כלי ההשוואה שבהם השתמשת ' אי פעם. (Git מציעה גם patience ו histogram גרסאות המייצרות לפעמים קבוצות קריאות יותר לאדם של אותם שינויים - ה סט של שינויים זהה, המצגת שונה.)
מאפיין אחד חשוב שאינו ברור: הבדל אינו תמיד ייחודי. אם אתה מוסיף שורה ריקה בין שתי שורות ריקות קיימות, " which" שורה ריקה היא חדשה היא באמת מעורפלת, וכלים שונים עשויים להדגיש כלים שונים. שתי התשובות נכונות.
הבדל שורה, מילה או תו - איזה מצב מתי?
הפירוט שאתה משווה בשינויים למה הפלט טוב. לטעות זו היא הסיבה העיקרית שאנשים מוצאים פלט שונה "רועש."
| רמת קו | ברמת המילה | רמת אופי | |
|---|---|---|---|
| משווה | קווים שלמים כאטומים | מילים בודדות | דמויות בודדות |
| עריכה של מילה אחת מציגה כ | כל השורה הוסרה + הוספה מחדש | רק המילה הזאת | רק האותיות שהשתנו |
| הטוב ביותר עבור | קוד, configs, שורות CSV | פרוזה, חוזים, מסמכים | שגיאות הקלדה, גיבוב, מחרוזות מקודדות |
| חולשה Weakness | עריכות ארוכות: אתה עדיין צד בתוך הקו | רועש על פני טקסט שזורם מחדש/עטוף מחדש | לא קריא עבור עריכות גדולות |
| משתמש קלאסי | git diff |
קו שחור משפטי / ביקורת עריכה | " שני מפתחות API אלה נראים זהים" |
דוגמה קונקרטית. מְקוֹרִי: The quick brown fox jumps over the lazy dog. שונה: The quick red fox leaps over the lazy cat.
- מצב קו מסמן את כל המשפט כשונה - מדויק, לא מועיל.
- מצב מילים מדגיש בדיוק
brown→red,jumps→leaps,dog→cat. - מצב תווים האם מוגזם כאן, אבל זה ' הוא המצב היחיד שיתפוס
admlnistratorvsadministrator.
כלל אצבע: טקסט מובנה (הצהרה משמעותית אחת לכל שורה) רוצה מצב שורה; טקסט זורם רוצה מצב מילה; מצב תו הוא זכוכית מגדלת שאתה שולף כאשר השניים האחרים אומרים "changed" ואתה יכול ' לא מבין למה. באג הרווח הנגרר שלי הוא המקרה הקנוני של מצב תו.
מתי כלי הבדל עצמאי טוב יותר מ-Git?
Git's diff מצוין לדברים שחיים באותו מאגר. כמות מפתיעה של עבודת השוואה עושה 't:
כרטיסי תמיכה. התרחיש מתוך המבוא שלי - שתי הגדרות ייצוא מלקוח. They're לא בשום repo.הדבק את שניהם לתוך ה כלי Text Diff והתשובה מופיעה בשניות במקום שתי קריאות כושלות.
סחף תצורה. בימוי nginx config לעומת ייצור nginx config. נוכחי .env לעומת הגיבוי מלפני שהדברים נשברו. git diff can't see files on two different servers; copy-paste יכול.
אימות פורמט. הרצת את Prettier (או PHPCS, או Black) על פני קובץ ואתה רוצה שהביטחון שלו ישתנה עיצוב בלבד. הבדל את לפני ואחרי: אם אתה רואה משהו אחר מלבד רווח לבן, ציטוטים ונקודות נקודה, המעצב נגע בלוגיקה ואתה רוצה לדעת עכשיו.
שתי תגובות API. Staging מחזירה גוף JSON אחד, ההפקה מחזירה גוף אחר, והחזית רק נשברת בבימוי. הבדל את התגובות. (עבור JSON ספציפית, העדיפו את JSON Diff- זה משווה מבנה מנותח, אז סדר מפתח ורווח לבן don' לא ליצור תוצאות חיוביות שגויות. הפעל את שני המטענים דרך פורמט JSON ראשית אם אתה רוצה הבדל טקסט קריא במקום זאת.)
מסמכים וחוזים. ספק מחזיר " אותו חוזה עם עדכונים קלים." הבדל במצב מילה הוא איך אתה מגלה שתנאי התשלום עברו מ-Net 30 ל-Net 15 במסמך בן 40 עמודים. עורכים ועורכי דין ידעו זאת לנצח - הם קוראים לזה קו שחור או קו אדום.
קבצי תרגום ולוקליזציה. השוואת שתי גרסאות של א .po קובץ כדי לראות אילו מחרוזות השתנו בפועל לפני שליחתן חזרה למתרגמים - זרימת עבודה אמיתית של WP Adminify שחוסכת תשלום לתרגום מחדש של 400 מחרוזות ללא שינוי.
החוט המשותף: ברגע ששתי הגרסאות קיימות כטקסט אתה יכול לבחור, כלי הבדל עונה "מה השתנה?" באופן מכני. ומכיוון שהכלי Toolz.dev הוא בצד הלקוח, מדביק customer's config או חוזה לא חתום does't משדר אותו לכל מקום - אותו טיעון כמו שאר ה פרטיות-ארגז כלים ראשון.
איך אתה קורא פלט שונה מבלי לרמות את עצמך?
מוסכמות הצבעים היא אוניברסלית: אדום הוא הגרסה הישנה 's תוכן בלעדי (הוסר), ירוק הוא הגרסה החדשה 's (נוסף), טקסט ללא שינוי הופך רגיל להקשר. שורה שהשתנתה מופיעה כקו אדום ואחריו החלפתו הירוקה.
שלושה הרגלים שהופכים את הביקורת לאמינה למעשה:
שים את הגרסאות בחריצים הנכונים. ישן/מקורי משמאל (או שדה ראשון), חדש/שונה מימין החלף אותם וכל תוספת נכתבת כמחיקה - I' צפיתי באנשים מנפים באגים בכיוון הלא נכון במשך עשר דקות בגלל זה אם הפלט מסתכל אחורה, זה כנראה.
החליטו מהו רעש לפני שאתם מתחילים. השוואת קוד מעוצב מחדש? שינויים ב-Whitespace הם רעש - נרמל או התעלם מהם. השוואת תצורות YAML? Whitespace הוא משמעות- הזחה היא מבנה ב-YAML, אז אמת את שני הצדדים ב- מאמת יאמל ולהתייחס לכל חלל כאות אותו כלי, מדיניות הפוכה, ובחירה לא נכונה או קוברת את השינוי האמיתי ברעש או מסתירה אותו.
תקרא כל חתיך, לא רק את הראשון. הלקוח's שטח נגרר היה שינוי #1 של 1. אבל כאשר הבדל מראה ארבעה שינויים והראשון מסביר את הסימפטום שלך, הפיתוי להפסיק לקרוא הוא חזק - ושינוי #3 הוא לפעמים זה שנושך אותך בשבוע הבא ההבדל כבר עשה את החלק הקשה; don't להציג מחדש טעות דגימה אנושית בשלב האחרון.
מה יכול'טקסט שונה אומר לך?
שווה להיות כנה לגבי הגבולות:
- בלוקים שהועברו נקראו כ-delete + add. חתוך פונקציה מהחלק העליון של קובץ והדבק אותה בתחתית: ה-diff מדווח שהיא הסירה והוסיפה, לא הוזזה. כמה כלים מיוחדים מזהים מהלכים; LCS רגיל 't.
- זה משווה טקסט, לא משמעות.
0.1 + 0.2ו0.3הבדל כמו שונה (הם) אבל גם להתנהג אחרת בנקודה צפה - ולהפך,"key": 1vs"key": 1.0עשוי להיות שונה מבחינה טקסטואלית אך זהה מבחינה סמנטית בשפה שלך. השוואה מובנית (כמו ה JSON Diff) סוגר חלק מהפער הזה עבור פורמטים של נתונים. - תוכן בינארי הוא מחוץ לתחום. תמונות, קובצי PDF כבתים, קובצי הפעלה - text diff זקוק לטקסט. חלץ תחילה את הטקסט, או השתמש בכלים ספציפיים לפורמט.
- מקרה וקידוד מושווים מילולית.
README≠readme, וציטוט מתולתל UTF-8 ≠ ציטוט ישר ASCII למרות שהם נראים זהים ברוב הגופנים. (מלכודת דפוס צורה אחרת לעיניים, ניצחון נוסף לאלגוריתם.) נרמל מראש עם ה מַגִישׁ אם המקרה צריך ' לא משנה להשוואה שלך.
שאלות נפוצות
האם אני יכול להשוות קבצים, או רק טקסט מודבק?
ה כלי Text Diff עובד על טקסט מודבק: פתח כל קובץ בכל עורך, העתק, הדבק את שני הצדדים. זה הופך אותו לאגנוסטי לפורמט - כל דבר ש-' ניתן להשוות טקסט קריא (קוד, תצורה, CSV, SQL, פרוזה), ללא קשר לסיומת.
האם יש מגבלת גודל להשוואה?
המגבלה המעשית היא המכשיר שלך & #39;s זיכרון, מאז עיבוד הוא בדפדפן.Files עם כמה אלפי שורות להשוות באופן מיידי; אלגוריתם מאיירס & #39;s עלות סולמות עם מספר של הבדלים, אז אפילו טקסטים גדולים אך דומים נשארים מהירים. מאות אלפי שורות עם הבדלים מסיביים עשויים להימשך מספר שניות.
באיזה מצב הבדל עלי להשתמש עבור קוד?
מצב קו. הקוד הוא באופן טבעי הצהרה אחת לשורה, אז פלט ברמת הקו ממפה בצורה נקייה את האופן שבו אתה חושב על השינוי. עבור למצב מילה או תו רק כאשר שורה מסומנת כשונה ואתה יכול 't לזהות את ההבדל בתוכה - that's בדרך כלל רווח לבן, מרכאות או תו בודד.
איזה מצב הכי מתאים לחוזים ולפרוזה?
מצב מילה. שינויים בפרוזה הם בדרך כלל החלפות מילים וסעיפים מוכנסים בתוך פסקאות ארוכות; מצב שורה יסמן פסקאות שלמות וישאיר אותך לצוד. הדגשה ברמת המילה מראה בדיוק אילו מילים השתנו - אותה גישה כמו קו שחור חוקי.
האם ההבדל משנה או מאחסן את הטקסט שלי?
מס 'הדגשה קיימת רק בפלט המעובד; טקסט הקלט שלך אינו משתנה, ומכיוון שהכלי פועל כולו בצד הלקוח, אף אחת מהגרסאות לא משודרת או מאוחסנת בשום מקום. סגור את הכרטיסייה והטקסטים נעלמו.
מדוע ההבדל מדגיש קו שנראה זהה?
תווים כמעט תמיד בלתי נראים: רווחים נגררים, כרטיסיות לעומת רווחים, Windows \r\n נגד יוניקס \n סיומות שורות, רווחים לא שוברים או דמויות מראה של Unicode (ציטוטים מתולתלים לעומת ישרים). זה בדיוק סוג השינוי שעיניים אנושיות לא יכולות לראות ואלגוריתמים שונים תמיד תופסים - כרטיס התמיכה שלי במרחב הנגרר היה אחד מאלה.
האם זה יכול לזהות טקסט זז?
לא כצעד. הבדל סטנדרטי מבוסס LCS מדווח על בלוק שהועבר כפי שנמחק מהמיקום הישן ונוסף במיקום החדש. אם אתה חושד במהלך, חפש ב-" הוסף" טקסט במקור - פגיעה מדויקת במקום אחר בקובץ מאשרת זאת.
במה שונה JSON Diff מ-Text Diff?
הבדל טקסט משווה תווים; JSON Diff מנתח את שני המסמכים ומשווה מבנה. מפתחות מסודרים מחדש, הזחה שונה ופסיקים נגררים מייצרים אפס הבדלים מבניים, כך שאתה רואה רק שינויים בערכים ובמפתחות בפועל. השתמש בו בכל פעם ששני הצדדים חוקיים JSON; חזור ל-diff טקסט כשהם 't.
כיצד אוכל להתעלם מרווח לבן או מקרה בעת השוואת טקסט?
החליטו תחילה אם רווח לבן הוא רעש או אות: בקוד מעוצב מחדש זה רעש, אבל בהזחה של YAML או Python זה מבנה. כאשר מדובר ברעש, נרמל את שני הצדדים לפני הבדל - כווץ רווחים חוזרים, הסר רווחים נגררים והפוך את סיומות השורות לעקביות - כך שנותרו רק שינויים אמיתיים. כדי להתעלם ממקרה, יש להקטין את שני הטקסטים לפני ההשוואה, מכיוון שההבדל מתייחס ל-README ול-readme כשונים כברירת מחדל.
באיזה אלגוריתם משתמש git diff?
כברירת מחדל, git diff משתמש בגרסה של אלגוריתם מאיירס, אותה גישה בעלת רצף משותף הארוך ביותר של Eugene Myers' מאמר משנת 1986 שרוב כלי ההבדל חולקים. Git מציעה גם גרסאות סבלנות והיסטוגרמה שיכולות לקבץ שינויים בצורה קריא יותר, אך הן מדווחות על אותה קבוצה של הבדלים - רק המצגת משתנה כלי זה משתמש באותה משפחת אלגוריתמים של מאיירס.
