نام (NAME)

git-reset - بازنشانی HEAD یا ایندکس به یک وضعیت مشخص

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

git reset [--ft | --xed [-N] | --
git reset [-q] [<tree-ish>] [--] <pathspec>...
git reset [-q] [--athspec-from-file=<file>
[--athspec-file-nul]]
[<tree-ish>]
git reset (--atch
| -p) [<tree-ish>] [--] [<pathspec>...]

توضیحات (DESCRIPTION)

دستور git reset یکی از کارهای زیر را انجام می‌دهد:

برای آشنایی با تفاوت‌های میان این سه دستور، بخش "Reset, restore and revert" را در git(1) ببینید.

گزینه‌ها (OPTIONS)

-q, --quiet

--efresh, --0-refresh

--athspec-from-file=<file>

--athspec-file-nul

-U<n>, --nified=<n>

--inter-hunk-context=<n>

--

<pathspec>...

مثال‌ها (EXAMPLES)

لغو دستور add

$ edit                                     (1)
$ git add frotz.c filfre.c
$ mailx                                    (2)
$ git reset                                (3)
$ git pull git://info.example.com/ nitfol  (4)

لغو یک کامیت و انجام مجدد آن

$ git commit ...
$ git reset --ft HEAD^      (1)
$ edit                        (2)
$ git commit -a -c ORIG_HEAD  (3)

لغو یک کامیت و تبدیل آن به یک شاخه موضوعی

$ git branch topic/wip          (1)
$ git reset --
$ git switch topic/wip          (3)

حذف دائمی کامیت‌ها

$ git commit ...
$ git reset --

لغو یک ادغام (merge) یا دریافت (pull)

$ git pull                         (1)
Auto-merging nitfol
CONFLICT (content): Merge conflict in nitfol
Automatic merge failed; fix conflicts and then commit the result.
$ git reset --
$ git pull . topic/branch          (3)
Updating from 41223... to 13134...
Fast-forward
$ git reset --

لغو ادغام یا pull در یک درخت کاری دارای تغییرات

$ git pull                         (1)
Auto-merging nitfol
Merge made by recursive.
 nitfol                |   20 +++++---- ...
$ git reset --rge ORIG_HEAD      (2)

جریان کاری دچار وقفه

$ git switch feature  ;# you were working in "feature" branch and
$ work work work      ;# got interrupted
$ git commit -a -m "snapshot WIP"                 (1)
$ git switch master
$ fix fix fix
$ git commit ;# commit with real log
$ git switch feature
$ git reset --ft HEAD^ ;# go back to WIP state  (2)
$ git reset                                       (3)

بازنشانی یک فایل خاص در ایندکس

$ git reset -- frotz.c                      (1)
$ git commit -m "Commit files in index"     (2)
$ git add frotz.c                           (3)

حفظ تغییرات در درخت کاری همزمان با حذف برخی کامیت‌های قبلی

$ git tag start
$ git switch -c branch1
$ edit
$ git commit ...                            (1)
$ edit
$ git switch -c branch2                     (2)
$ git reset --ep start                    (3)

تقسیم یک کامیت به توالی چند کامیت مجزا

$ git reset -N HEAD^                        (1)
$ git add -p                                (2)
$ git diff --ached                         (3)
$ git commit -c HEAD@{1}                    (4)
...                                         (5)
$ git add ...                               (6)
$ git diff --ached                         (7)
$ git commit ...                            (8)

بحث و بررسی (DISCUSSION)

جدول‌های زیر نشان می‌دهند هنگام اجرای دستور زیر چه اتفاقی می‌افتد:

git reset --

برای بازنشانی HEAD به یک کامیت دیگر (target) با گزینه‌های مختلف بازنشانی بسته به وضعیت فایل‌ها.

در این جدول‌ها، A، B، C و D وضعیت‌های متفاوتی از یک فایل هستند. برای مثال، سطر اول جدول نخست به این معنی است که اگر یک فایل در درخت کاری در وضعیت A، در ایندکس در وضعیت B، در HEAD در وضعیت C و در target در وضعیت D باشد، آنگاه git reset --ft target فایل را در درخت کاری در وضعیت A و در ایندکس در وضعیت B باقی می‌گذارد. این دستور HEAD (یعنی سرشاخه شاخه فعلی، در صورت حضور در یکی از شاخه‌ها) را به target (که فایل را در وضعیت D دارد) بازنشانی می‌کند (یعنی انتقال می‌دهد).

working index HEAD target         working index HEAD
--------------------------------------------------- A       B     C    D     --ft   A       B     D
                          --xed  A       D     D
                          --
                          --rge (disallowed)
                          --ep  (disallowed)

working index HEAD target         working index HEAD
--------------------------------------------------- A       B     C    C     --ft   A       B     C
                          --xed  A       C     C
                          --
                          --rge (disallowed)
                          --ep   A       C     C

working index HEAD target         working index HEAD
--------------------------------------------------- B       B     C    D     --ft   B       B     D
                          --xed  B       D     D
                          --
                          --rge  D       D     D
                          --ep  (disallowed)

working index HEAD target         working index HEAD
--------------------------------------------------- B       B     C    C     --ft   B       B     C
                          --xed  B       C     C
                          --
                          --rge  C       C     C
                          --ep   B       C     C

working index HEAD target         working index HEAD
--------------------------------------------------- B       C     C    D     --ft   B       C     D
                          --xed  B       D     D
                          --
                          --rge (disallowed)
                          --ep  (disallowed)

working index HEAD target         working index HEAD
--------------------------------------------------- B       C     C    C     --ft   B       C     C
                          --xed  B       C     C
                          --
                          --rge  B       C     C
                          --ep   B       C     C

دستور git reset --rge برای استفاده هنگام بازنشانی از یک ادغام دارای تعارض در نظر گرفته شده است. هر عملیات ادغام تضمین می‌کند فایل درخت کاری که در ادغام دخیل است، پیش از شروع عملیات نسبت به ایندکس تغییر محلی نداشته باشد، و نتیجه را در درخت کاری می‌نویسد. بنابراین اگر تفاوتی بین ایندکس و target و همچنین بین ایندکس و درخت کاری مشاهده کنیم، به این معنی است که ما از وضعیتی که یک عملیات ادغام پس از شکست با تعارض باقی گذاشته بازنشانی نمی‌کنیم. به همین دلیل در این حالت گزینه --rge را مجاز نمی‌دانیم.

دستور git reset --ep برای استفاده هنگام حذف برخی از آخرین کامیت‌ها در شاخه فعلی در عین حفظ تغییرات در درخت کاری در نظر گرفته شده است. اگر تعارض احتمالی بین تغییرات موجود در کامیتی که می‌خواهیم حذف کنیم و تغییرات موجود در درخت کاری که می‌خواهیم نگه داریم وجود داشته باشد، بازنشانی غیرمجاز است. به همین دلیل اگر هم بین درخت کاری و HEAD و هم بین HEAD و target تغییراتی وجود داشته باشد، غیرمجاز است. برای ایمنی بیشتر، در صورت وجود ورودی‌های ادغام‌نشده نیز غیرمجاز است.

جدول‌های زیر نشان می‌دهند هنگامی که ورودی‌های ادغام‌نشده وجود دارند چه اتفاقی می‌افتد:

working index HEAD target         working index HEAD
--------------------------------------------------- X       U     A    B     --ft  (disallowed)
                          --xed  X       B     B
                          --
                          --rge  B       B     B
                          --ep  (disallowed)

working index HEAD target         working index HEAD
--------------------------------------------------- X       U     A    A     --ft  (disallowed)
                          --xed  X       A     A
                          --
                          --rge  A       A     A
                          --ep  (disallowed)

X به معنای هر وضعیتی و U به معنای ایندکس ادغام‌نشده است.

گیت (GIT)

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