git-add - מקוון בענן

תָכְנִית:

שֵׁם

git-add - הוסף תוכן קובץ לאינדקס

תַקצִיר

סילון להוסיף [--מילולית | -v] [--הרצה יבשה | -n] [--כוח | -f] [--אינטראקטיבי | -i] [--תיקון | -פ]
[--ערוך | -ה] [--[לא-]כל | --[לא-]הסרה של התעלמות | [--עדכון | -u]]
[--כוונה-להוסיף | -N] [--רענן] [--התעלם-שגיאות] [--התעלם-חסר]
[--] [ ...]

תיאור

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

ה"אינדקס" מחזיק תמונת מצב של תוכן עץ העבודה, וזו תמונת המצב הזו
זה נחשב כתוכן ההתחייבות הבאה. כך לאחר ביצוע שינויים כלשהם ב
עץ עבודה, ולפני הפעלת הפקודה commit, עליך להשתמש בפקודה add כדי להוסיף
כל קובץ חדש או שונה לאינדקס.

ניתן לבצע פקודה זו מספר פעמים לפני commit. זה רק מוסיף את התוכן של
הקבצים שצוינו בזמן הפעלת פקודת ההוספה; אם אתה רוצה שינויים הבאים
נכלל ב-commit הבא, אז עליך להפעיל את git add שוב כדי להוסיף את התוכן החדש ל-
אינדקס.

ניתן להשתמש בפקודת git status כדי לקבל סיכום של הקבצים שיש בהם שינויים
מבוימים לקראת ההתחייבות הבאה.

הפקודה git add לא תוסיף קבצים שהתעלמו מהם כברירת מחדל. אם היו קבצים שהתעלמו מהם
שצוין במפורש בשורת הפקודה, git add ייכשל עם רשימה של קבצים שהתעלמו מהם.
קבצים שהתעלמו אליהם הגיעו על ידי רקורסיה של ספרייה או גלוב של שם קובץ שבוצע על ידי Git (ציטוט
הכדורים שלך לפני הקליפה) יתעלמו בשקט. ה סילון להוסיף ניתן להשתמש בפקודה
הוסף קבצים שהתעלמו מהם עם האפשרות -f (כוח).

עיין git-commit(1) לדרכים חלופיות להוספת תוכן להתחייבות.

אפשרויות

...
קבצים להוספת תוכן. ניתן לתת Fileglobs (למשל *.c) כדי להוסיף את כל ההתאמה
קבצים. גם שם ספרייה מוביל (למשל dir כדי להוסיף dir/file1 ו-dir/file2) יכול להיות
ניתן כדי לעדכן את האינדקס כך שיתאים למצב הנוכחי של הספרייה בכללותה (למשל
ציון dir יתעד לא רק קובץ dir/file1 ששונה בעץ העבודה, א
קובץ dir/file2 נוסף לעץ העבודה, אבל גם קובץ dir/file3 הוסר מהקובץ
עץ עבודה. שימו לב שגרסאות ישנות יותר של Git נהגו להתעלם מקבצים שהוסרו; להשתמש
אפשרות --no-all אם ברצונך להוסיף קבצים ששונו או חדשים אך להתעלם מאלה שהוסרו.

-n, --- יבש-ריצה
אל תוסיף את הקבצים, פשוט הראה אם ​​הם קיימים ו/או יתעלמו מהם.

-v, --מלל
היו מילוליים.

-f, --כוח
אפשר הוספת קבצים שהתעלמו מהם אחרת.

-i, --אינטראקטיבי
הוסף תוכן שונה בעץ העבודה באופן אינטראקטיבי לאינדקס. נתיב אופציונלי
ניתן לספק ארגומנטים כדי להגביל את הפעולה לתת-קבוצה של עץ העבודה. לִרְאוֹת
"מצב אינטראקטיבי" לפרטים.

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

זה למעשה מריץ add --interactive, אבל עוקף את תפריט הפקודות הראשוני ו
קופץ ישירות לתת-פקודה של תיקון. ראה "מצב אינטראקטיבי" לפרטים.

-e, - Tit
פתח את ההבדל לעומת האינדקס בעורך ואפשר למשתמש לערוך אותו. אחרי העורך
נסגר, התאם את כותרות החתיכות והחל את התיקון על האינדקס.

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

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

אם לא ניתנת כאשר נעשה שימוש באפשרות -u, כל הקבצים במעקב כולו
עץ העבודה מתעדכן (גרסאות ישנות של Git משמשות להגביל את העדכון לקיים
ספרייה וספריות המשנה שלה).

-A, --all, --אין-הסרה-לא להתעלם
עדכן את האינדקס לא רק כאשר לעץ העבודה יש ​​קובץ תואם אבל
גם כאשר לאינדקס כבר יש ערך. זה מוסיף, משנה ומסיר אינדקס
ערכים שיתאימו לעץ העבודה.

אם לא ניתן כאשר נעשה שימוש באפשרות -A, כל הקבצים בעץ העבודה כולו
מעודכנים (גרסאות ישנות של Git משמשות להגבלת העדכון לספרייה הנוכחית ו
ספריות המשנה שלו).

--לא-הכל, --התעלם-הסרה
עדכן את האינדקס על ידי הוספת קבצים חדשים שאינם ידועים לאינדקס וקבצים ששונו
בעץ העבודה, אך התעלם מקבצים שהוסרו מעץ העבודה.
אפשרות זו היא ללא הפעלה כאשר לא משמש.

אפשרות זו נועדה בעיקר לעזור למשתמשים שרגילים לגרסאות ישנות יותר של Git, שלהם
"תוסיף ..." הייתה מילה נרדפת ל"git add --no-all ...", כלומר
התעלמו מקבצים שהוסרו.

-N, --intent-to-add
רשום רק את העובדה שהנתיב יתווסף מאוחר יותר. כניסה לשביל היא
ממוקם באינדקס ללא תוכן. זה שימושי בין היתר להצגה
התוכן הלא מבוים של קבצים כאלה עם git diff וביצועם עם git commit
-א.

--לְרַעֲנֵן
אל תוסיף את הקבצים, אלא רק רענן את המידע ה-stat() שלהם באינדקס.

--התעלם משגיאות
אם לא ניתן היה להוסיף קבצים מסוימים בגלל שגיאות באינדקס שלהם, אל תבטל את
הפעולה, אך המשך להוסיף את האחרים. הפקודה עדיין תצא ללא אפס
סטָטוּס. ניתן להגדיר את משתנה התצורה add.ignoreErrors ל-true כדי לעשות זאת
התנהגות ברירת המחדל.

--התעלם-חסר
ניתן להשתמש באפשרות זו רק יחד עם --dry-run. על ידי שימוש באפשרות זו המשתמש
יכול לבדוק אם יתעלמו מאחד מהקבצים הנתונים, לא משנה אם הם כבר
נוכח בעץ העבודה או לא.

--
ניתן להשתמש באפשרות זו כדי להפריד בין אפשרויות שורת הפקודה מרשימת הקבצים,
(שימושי כאשר שמות קבצים עשויים להיחשב בטעות לאפשרויות שורת הפקודה).

תְצוּרָה

משתנה התצורה האופציונלי core.excludesFile מציין נתיב לקובץ
המכיל דפוסים של שמות קבצים להחרגה מ-git-add, בדומה ל
$GIT_DIR/info/exclude. תבניות בקובץ אי הכללה משמשות בנוסף לאלו שב
מידע/אי הכללה. לִרְאוֹת גיטיגנור(5).

דוגמאות

· מוסיף תוכן מכל קבצי *.txt תחת ספריית התיעוד ושלה
ספריות משנה:

$ git add Documentation/\*.txt

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

· שוקל להוסיף תוכן מכל הסקריפטים של git-*.sh:

$ git הוסף git-*.sh

מכיוון שדוגמה זו מאפשרת למעטפת להרחיב את הכוכבית (כלומר אתה מפרט את
קבצים במפורש), הוא אינו מחשיב את subdir/git-foo.sh.

אינטראקטיבי MODE

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

לולאת הפקודה מציגה את רשימת פקודות המשנה הזמינות, ונותנת הנחיה "מה עכשיו> ".
באופן כללי, כאשר ההנחיה מסתיימת בסינגל >, אתה יכול לבחור רק אחת מהאפשרויות
נתון והקלד החזר, כך:

*** פקודות ***
1: סטטוס 2: עדכון 3: חזור 4: הוסף ללא מעקב
5: תיקון 6: הבדל 7: עזוב 8: עזרה
מה עכשיו> 1

אתה יכול גם לומר s או sta או סטטוס למעלה כל עוד הבחירה היא ייחודית.

לולאת הפקודה הראשית כוללת 6 פקודות משנה (בתוספת עזרה ויציאה).

מצב
זה מראה את השינוי בין HEAD לאינדקס (כלומר מה יהיה מחויב אם תגיד
git commit), ובין קבצי אינדקס ועץ עבודה (כלומר מה שאתה יכול לביים
עוד לפני git commit באמצעות git add) עבור כל נתיב. פלט לדוגמה נראה כמו
זֶה:

נתיב לא מבוים
1: שום דבר בינארי foo.png
2: +403/-35 +1/-1 git-add--interactive.perl

זה מראה שלfoo.png יש הבדלים מ-HEAD (אבל זה בינארי אז ספירת שורות
לא ניתן להציג) ואין הבדל בין עותק באינדקס לבין עץ העבודה
גרסה (אם גם גרסת עץ העבודה הייתה שונה, בינרי היה מוצג
במקום שום דבר). לקובץ השני, git-add--interactive.perl, נוספו 403 שורות
ו-35 שורות נמחקות אם אתה מתחייב מה יש באינדקס, אבל קובץ עץ עובד יש
שינויים נוספים (תוספת אחת ומחיקה אחת).

עדכון
זה מציג את מידע הסטטוס ומוציא הודעת "עדכון>>". כאשר ההנחיה
מסתיים בכפול >>, אתה יכול לעשות יותר מבחירה אחת, משולבת עם
רווח לבן או פסיק. כמו כן אתה יכול לומר טווחים. למשל "2-5 7,9" כדי לבחור 2,3,4,5,7,9
מהרשימה. אם המספר השני בטווח מושמט, כל הטלאים הנותרים כן
נלקח. למשל "7-" כדי לבחור 7,8,9 מהרשימה. אתה יכול להגיד * לבחור הכל.

מה שבחרת יודגש לאחר מכן *, ככה:

נתיב לא מבוים
1: שום דבר בינארי foo.png
* 2: +403/-35 +1/-1 git-add--interactive.perl

כדי להסיר את הבחירה, הקדימו של הקלט עם - כך:

עדכון >> -2

לאחר ביצוע הבחירה, ענו בשורה ריקה כדי לשלב את תוכן העבודה
קבצי עץ עבור נתיבים נבחרים באינדקס.

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

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

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

y - שלב את החתיך הזה
n - אין לביים את החתיך הזה
ש - עזוב; אין לביים את החתיך הזה או את כל אחד מהנותרים
a - שלב את החתיך הזה ואת כל החתכים המאוחרים יותר בקובץ
ד - אל תשלב את החתיכה הזו או אף אחד מהחתכים המאוחרים בקובץ
g - בחר חתיך ללכת אליו
/ - חפש חתך התואם את הביטוי הרגולרי הנתון
j - השאר את החתיך הזה מתלבט, ראה את החתיך המתלבט הבא
J - השאר את החתיך הזה מתלבט, ראה את החתיך הבא
k - השאר את החתיך המתלבט הזה, ראה חתיך המתלבט הקודם
K - השאר את החתיך הזה מתלבט, ראה את החתיך הקודם
s - פצל את החתך הנוכחי לחתכים קטנים יותר
e - ערוך באופן ידני את החתיך הנוכחי
? - עזרה בהדפסה

לאחר החלטת הגורל של כל החתיכים, אם יש חתיך כלשהו שנבחר, המדד
מתעדכן עם החתיכים שנבחרו.

אתה יכול להשמיט את הצורך להקליד return כאן, על ידי הגדרת משתנה התצורה
interactive.singleKey to true.

הבדל
זה מאפשר לך לבדוק מה יתחייב (כלומר בין HEAD לאינדקס).

עריכה טלאים

הפעלת git add -e או בחירה ב-e מבורר החתיכה האינטראקטיבי תפתח תיקון
העורך שלך; לאחר יציאת העורך, התוצאה מוחלת על האינדקס. אתה חופשי
בצע שינויים שרירותיים בתיקון, אך שים לב שחלק מהשינויים עשויים לבלבל
תוצאות, או אפילו לגרום לתיקון שלא ניתן להחיל. אם אתה רוצה לבטל את
פעולה לחלוטין (כלומר, שלב שום דבר חדש באינדקס), פשוט מחק את כל השורות של
תיקון. הרשימה שלהלן מתארת ​​כמה דברים נפוצים שאתה עשוי לראות בתיקון, ואילו
פעולות עריכה הגיוניות לגביהן.

תוכן נוסף
תוכן נוסף מיוצג על ידי שורות המתחילות ב-"+". אתה יכול למנוע בימוי כל
הוספת שורות על ידי מחיקתן.

תוכן שהוסר
תוכן שהוסר מיוצג על ידי שורות המתחילות ב-"-". אתה יכול למנוע בימוי
הסרתם על ידי המרת ה-"-" ל-" " (רווח).

תוכן שונה
תוכן שונה מיוצג על ידי שורות "-" (הסרת התוכן הישן) ואחריהן
שורות "+" (הוספת התוכן החלופי). אתה יכול למנוע את ביצוע השינוי
על ידי המרת שורות "-" ל- ", והסרת שורות "+". היזהר כי שינוי בלבד
מחצית מהצמד עשויה להציג שינויים מבלבלים במדד.

יש גם פעולות מורכבות יותר שניתן לבצע. אבל היזהר כי בגלל ה
תיקון מוחל רק על האינדקס ולא על עץ העבודה, עץ העבודה יופיע
כדי "לבטל" את השינוי באינדקס. לדוגמה, הכנסת שורה חדשה לאינדקס ש
הוא לא ב-HEAD ולא בעץ העבודה ישלב את השורה החדשה להתחייבות, אבל ה
נראה שהקו חזר בעץ העבודה.

הימנע משימוש במבנים אלה, או עשה זאת בזהירות רבה.

הסרת תוכן שלא נפגע
תוכן שאינו שונה בין האינדקס לעץ העבודה עשוי להיות מוצג
קווי הקשר, המתחילים ב- " " (רווח). אתה יכול לביים שורות הקשר להסרה
על ידי המרת הרווח ל-"-". קובץ עץ העבודה המתקבל יופיע
הוסף מחדש את התוכן.

שינוי תוכן קיים
אפשר גם לשנות שורות ההקשר על ידי הצבתן להסרה (על ידי המרת " " ל
"-") והוספת שורת "+" עם התוכן החדש. באופן דומה, אפשר לשנות שורות "+".
עבור תוספות או שינויים קיימים. בכל המקרים, השינוי החדש יהיה
מופיעים הפוך בעץ העבודה.

תוכן חדש
אתה יכול גם להוסיף תוכן חדש שלא קיים בתיקון; פשוט הוסף שורות חדשות,
כל אחד מתחיל ב-"+". התוספת תופיע חזרה בעץ העבודה.

יש גם כמה פעולות שיש להימנע לחלוטין, שכן הן יגרמו ל
תיקון בלתי אפשרי ליישום:

· הוספת הקשר (" ") או הסרה ("-") שורות

· מחיקת קווי הקשר או הסרה

· שינוי התוכן של שורות ההקשר או ההסרה

השתמש ב-git-add באינטרנט באמצעות שירותי onworks.net