نام (NAME)

git-add - افزودن محتویات فایل به ایندکس

خلاصه دستور (SYNOPSIS)

git add [--verbose | -v] [--dry-run | -n] [--force | -f] [--interactive | -i] [--patch | -p]
        [--edit | -e] [--[no-]all | -A | --[no-]ignore-removal | [--update | -u]] [--sparse]
        [--intent-to-add | -N] [--refresh] [--ignore-errors] [--ignore-missing] [--renormalize]
        [--chmod=(+|-)x] [--pathspec-from-file=<file> [--pathspec-file-nul]]
        [--] [<pathspec>...]

توضیحات (DESCRIPTION)

محتویات فایل‌های جدید یا تغییریافته را به ایندکس اضافه می‌کند. «ایندکس» (که به عنوان «محیط آماده‌سازی» یا «staging area» نیز شناخته می‌شود) فضایی است که برای آماده‌سازی محتویات کامیت بعدی از آن استفاده می‌کنید.

هنگامی که دستور git commit را بدون هیچ آرگومان دیگری اجرا می‌کنید، تنها تغییرات آماده‌شده (staged) را کامیت خواهد کرد. برای مثال، اگر file.c را ویرایش کرده‌اید و می‌خواهید تغییرات آن فایل را کامیت کنید، می‌توانید دستورات زیر را اجرا نمایید:

git add file.c
git commit

همچنین می‌توانید با استفاده از git add -p تنها بخشی از تغییرات اعمال‌شده در یک فایل را اضافه کنید.

این دستور را می‌توان چندین بار پیش از یک کامیت اجرا کرد. این دستور تنها محتویات فایل(های) مشخص‌شده را در همان لحظه اجرای دستور add اضافه می‌کند؛ چنانچه مایلید تغییرات بعدی نیز در کامیت بعدی گنجانده شوند، باید git add را مجدداً اجرا کنید تا محتوای جدید به ایندکس افزوده شود.

دستور git status می‌تواند برای دریافت خلاصه‌ای از اینکه کدام فایل‌ها دارای تغییراتی هستند که برای کامیت بعدی آماده شده‌اند، استفاده شود.

دستور git add به طور پیش‌فرض فایل‌های نادیده‌گرفته‌شده (ignored) را اضافه نخواهد کرد. می‌توانید از گزینه --force برای افزودن فایل‌های نادیده‌گرفته‌شده استفاده کنید. اگر نام دقیق یک فایل نادیده‌گرفته‌شده را مشخص کنید، git add با نمایش فهرستی از فایل‌های نادیده‌گرفته‌شده با خطا متوقف خواهد شد. در غیر این صورت، این فایل را بی‌صدا نادیده می‌گیرد.

لطفاً برای روش‌های جایگزین افزودن محتوا به یک کامیت، به git-commit(1) مراجعه کنید.

گزینه‌ها (OPTIONS)

<pathspec>...

-n, --dry-run

-v, --verbose

-f, --force

--sparse

-i, --interactive

-p, --patch

-U<n>, --unified=<n>

--inter-hunk-context=<n>

-e, --edit

-u, --update

-A, --all, --no-ignore-removal

--no-all, --ignore-removal

-N, --intent-to-add

--refresh

--ignore-errors

--ignore-missing

--no-warn-embedded-repo

--renormalize

--chmod=(+|-)x

--pathspec-from-file=<file>

--pathspec-file-nul

--

مثال‌ها (EXAMPLES)

$ git add Documentation/\*.txt

$ git add git-*.sh

حالت تعاملی (INTERACTIVE MODE)

هنگامی که دستور وارد حالت تعاملی می‌شود، خروجی زیردستور status را نمایش داده و سپس وارد حلقه دستورات تعاملی خود می‌شود.

حلقه دستورات فهرستی از زیردستورهای موجود را نشان داده و اعلان "What now> " را ارائه می‌دهد. به طور کلی، هنگامی که اعلان با یک علامت > منفرد پایان می‌یابد، تنها می‌توانید یکی از گزینه‌های ارائه‌شده را انتخاب کرده و کلید Return (اینتر) را فشار دهید، مانند زیر:

*** Commands ***
  1: status       2: update       3: revert       4: add untracked
  5: patch        6: diff         7: quit         8: help
What now> 1

شما همچنین می‌توانید تا زمانی که انتخاب یکتا باشد، s یا sta یا status را در بالا وارد کنید.

حلقه اصلی دستور دارای ۶ زیردستور است (به علاوه help و quit).

status

         staged     unstaged path
1:       binary      nothing foo.png
2:     +403/-35        +1/-1 add-interactive.c

update

           staged     unstaged path
  1:       binary      nothing foo.png
* 2:     +403/-35        +1/-1 add-interactive.c

Update>> -2

revert

add untracked

patch

y - stage this hunk
n - do not stage this hunk
q - quit; do not stage this hunk or any of the remaining ones
a - stage this hunk and all later hunks in the file
d - do not stage this hunk or any of the later hunks in the file
g - select a hunk to go to
/ - search for a hunk matching the given regex
j - go to the next undecided hunk, roll over at the bottom
J - go to the next hunk, roll over at the bottom
k - go to the previous undecided hunk, roll over at the top
K - go to the previous hunk, roll over at the top
s - split the current hunk into smaller hunks
e - manually edit the current hunk
p - print the current hunk
P - print the current hunk using the pager
? - print help

diff

ویرایش پچ‌ها (EDITING PATCHES)

اجرای git add -e یا انتخاب e از انتخابگر تعاملی تکه‌تغییرات، یک وصله (patch) را در ویرایشگر شما باز خواهد کرد؛ پس از خروج از ویرایشگر، نتیجه روی ایندکس اعمال می‌شود. شما مجازید تغییرات دلخواهی در وصله ایجاد کنید، اما توجه داشته باشید که برخی تغییرات ممکن است نتایج گیج‌کننده‌ای داشته باشند یا حتی منجر به وصله‌ای شوند که اعمال آن غیرممکن باشد. اگر می‌خواهید عملیات را به طور کامل لغو کنید (یعنی هیچ چیز جدیدی در ایندکس آماده‌سازی نشود)، به سادگی تمام خطوط وصله را حذف کنید. فهرست زیر برخی از موارد رایجی را که ممکن است در یک وصله ببینید و عملیات ویرایشی که روی آن‌ها منطقی است را توصیف می‌کند.

added content

removed content

modified content

همچنین عملیات پیچیده‌تری وجود دارند که می‌توان انجام داد. اما مراقب باشید که چون وصله تنها روی ایندکس اعمال می‌شود و نه روی درخت کاری، به نظر می‌رسد که درخت کاری تغییرات ایندکس را «خنثی» (undo) می‌کند. برای مثال، وارد کردن یک خط جدید به ایندکس که نه در HEAD و نه در درخت کاری وجود دارد، خط جدید را برای کامیت آماده می‌کند، اما این خط در درخت کاری به صورت واگردانی‌شده (reverted) به نظر خواهد رسید.

از استفاده از این ساختارها خودداری کنید، یا با احتیاط فوق‌العاده این کار را انجام دهید.

removing untouched content

modifying existing content

new content

همچنین چندین عملیات وجود دارد که باید کاملاً از آن‌ها اجتناب شود، چرا که اعمال وصله را غیرممکن می‌سازند:

پیکربندی (CONFIGURATION)

تمام موارد زیر این خط در این بخش به طور گزینشی از مستندات git-config(1) گنجانده شده است. محتوای آن همان چیزی است که در آنجا یافت می‌شود:

add.ignoreErrors, add.ignore-errors (منسوخ‌شده)

همچنین ببینید (SEE ALSO)

git-status(1) git-rm(1) git-reset(1) git-mv(1) git-commit(1) git-update-index(1)

گیت (GIT)

بخشی از مجموعه git(1)