時にはgitはgit rm --cachedファイルをステージング解除することを提案しますgit reset HEAD file。どちらを使用すればよいですか？

編集：

D:\code\gt2>git init
Initialized empty Git repository in D:/code/gt2/.git/
D:\code\gt2>touch a

D:\code\gt2>git status
# On branch master
#
# Initial commit
#
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#
#       a
nothing added to commit but untracked files present (use "git add" to track)

D:\code\gt2>git add a

D:\code\gt2>git status
# On branch master
#
# Initial commit
#
# Changes to be committed:
#   (use "git rm --cached <file>..." to unstage)
#
#       new file:   a
#
D:\code\gt2>git commit -m a
[master (root-commit) c271e05] a
 0 files changed, 0 insertions(+), 0 deletions(-)
 create mode 100644 a

D:\code\gt2>touch b

D:\code\gt2>git status
# On branch master
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#
#       b
nothing added to commit but untracked files present (use "git add" to track)

D:\code\gt2>git add b

D:\code\gt2>git status
# On branch master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#       new file:   b
#

git rm --cached <filePath> ファイルのステージングを解除しませんが、実際にはリポジトリからのファイルの削除をステージングします（ファイルがすでにコミットされている場合）。ただし、ファイルは作業ツリーに残ります（追跡されていないファイルが残ります）。

git reset -- <filePath>うunstageいずれかが指定されたファイル（複数可）の変更を上演しました。

つまり、git rm --cachedステージングされた新しいファイルを使用した場合、以前にコミットされたことがないため、ステージングを解除したように見えます。

git 2.24を更新します
。この新しいバージョンのgit git restore --stagedでは、の代わりに使用できますgit reset。git docsを参照してください。

git rm --cachedインデックスからファイルを削除するために使用されます。ファイルがすでにリポジトリにある場合、はファイルをgit rm --cachedインデックスから削除し、作業ディレクトリに残します。コミットすると、ファイルもリポジトリから削除されます。基本的に、コミット後は、ファイルのバージョン管理を解除し、ローカルコピーを保持します。

git reset HEAD file（デフォルトでは--mixedフラグを使用しています）は、ファイルがすでにリポジトリ内にある場合とは異なり、ファイルのインデックスバージョンをリポジトリからのインデックスバージョン（HEAD）で置き換え、変更を効果的にステージング解除します。

バージョン管理されていないファイルの場合、ファイルがHEADに存在しなかったため、ファイル全体がステージング解除されます。この側面git reset HEAD fileでgit rm --cachedは同じですが、同じではありません（すでにリポジトリにあるファイルの場合で説明したように）

質問ですWhy are there 2 ways to unstage a file in git?が、gitで何かを実行する方法は1つだけではありません。それがその美しさです:)

非常に単純に：

• git rm --cached <file> gitがファイルの追跡を完全に停止するようにします（プレーンとは異なり、ファイルシステムに残しますgit rm*）
• git reset HEAD <file> 最後のコミット以降にファイルに加えられた変更をステージング解除します（ただし、コマンド名が示唆する可能性があるのとは逆に、ファイルシステムでそれらを元に戻しません**）。ファイルはリビジョン管理されたままです。

ファイルが以前にリビジョン管理されていなかった場合（つまりgit add、最初に編集したファイルのステージングを解除している場合）、2つのコマンドは同じ効果をもたらすため、これらは「何かを行う2つの方法」のように見えます」

_{* 以前にリポジトリにコミットされgit rm --cachedたファイルに関して、@ DrewTが回答で言及している警告に留意してください。この質問のコンテキストでは、追加されたばかりでまだコミットされていないファイルについては、何も心配する必要はありません。}

_{**その名前が原因でgit resetコマンドを使用するのは恥ずかしいほど長い間怖がっていました。それでも、今日でも、混乱しないように構文を調べることがよくあります。（更新：ようやく時間をかけてtldrページでの使用法git resetを要約したので、それがどのように機能するかについてのより良いメンタルモデルと、詳細を忘れたときのクイックリファレンスが手に入りました。）}

このスレッドは少し古いですが、直感的な問題ではないため、少しデモンストレーションを追加したいと思います。

me$ git status
# On branch master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#   new file:   to-be-added
#   modified:   to-be-modified
#   deleted:    to-be-removed
#

me$ git reset -q HEAD to-be-added

    # ok

me$ git reset -q HEAD to-be-modified

    # ok

me$ git reset -q HEAD to-be-removed

    # ok

# or alternatively:

me$ git reset -q HEAD to-be-added to-be-removed to-be-modified

    # ok

me$ git status
# On branch master
# Changes not staged for commit:
#   (use "git add/rm <file>..." to update what will be committed)
#   (use "git checkout -- <file>..." to discard changes in working directory)
#
#   modified:   to-be-modified
#   deleted:    to-be-removed
#
# Untracked files:
#   (use "git add <file>..." to include in what will be committed)
#
#   to-be-added
no changes added to commit (use "git add" and/or "git commit -a")

git reset HEAD （なし -q）は、変更されたファイルに関する警告を出し、その終了コードは1で、スクリプトのエラーと見なされます。

編集：git checkout HEAD to-be-modified to-be-removedアンステージングでも機能しますが、ワークスペースから変更を完全に削除します

git 2.23.0のアップデート：コマンドは随時変更されます。今、git status言う：

  (use "git restore --staged <file>..." to unstage)

... 3つのタイプの変更すべてで機能します

コミットしたくないファイルを誤ってステージングしていて、変更を確実に保持したい場合は、次のものも使用できます。

git stash
git stash pop

これにより、HEADへのリセットが実行され、変更が再適用され、コミットのために個々のファイルを再ステージングできるようになります。これは、プルリクエストの機能ブランチを作成するのを忘れた場合にも役立ちます（git stash ; git checkout -b <feature> ; git stash pop）。

問題のファイルがすでにリポジトリ内にあり、バージョン管理下にある場合（以前にコミットされた場合など）、これら2つのコマンドにはいくつかの微妙な違いがあります。

• git reset HEAD <file> 現在のコミットでファイルのステージを解除します。
• git rm --cached <file>今後のコミットのためにファイルのステージングを解除します。で再度追加されるまで、ステージは解除されgit add <file>ます。

そしてもう一つ重要な違いがあります：

• 実行git rm --cached <file>してブランチをリモートにプッシュした後、ローカルのワーキングセットではファイルが追跡されなくなる（つまり、フォルダーから物理的に削除されない）場合でも、リモートからブランチをプルすると、フォルダーからファイルが実際に削除されます。

この最後の違いは、チームの各開発者が異なる構成（つまり、異なるベースURL、IP、またはポート設定）を持つ構成ファイルを含むプロジェクトにとって重要であるためgit rm --cached <file>、ブランチをプルするユーザーを使用している場合、手動で再設定する必要があります。削除すると、リモートからブランチをプルしたユーザーにのみ影響が及ぶため、構成を作成するか、自分に送信して、IP設定などに再編集することができます。

をstage介してディレクトリ全体git add <folder>があり、ステージングされたリスト（つまり、実行時に生成されるリストgit status）からファイルを除外して、除外されたファイル内に変更を保持したいとします（何かに取り組んでいて、コミットの準備ができていませんが、あなたの仕事を失いたくない...）。あなたは単に使うことができます：

git reset <file>

あなたが実行するとgit status、あなたはどんなファイル（複数可）が表示されますresetされているunstagedと、ファイルの残りの部分addedに残っているstagedリスト。

1。

D:\code\gt2>git status
# On branch master
#
# Initial commit
#
# Changes to be committed:
#   (use "git rm --cached <file>..." to unstage)
#
#       new file:   a

（ステージングを解除するには、「git rm --cached ...」を使用します）

• gitはポインターのシステムです

• ポインタを変更するコミットがまだありません

• 「ポイントされているバケットからファイルを取り出す」唯一の方法は、変更を監視するようにgitに指示したファイルを削除することです

2。

D:\code\gt2>git commit -m a
[master (root-commit) c271e05] a
0 files changed, 0 insertions(+), 0 deletions(-) create mode 100644 a

git commit -ma

• あなたがコミットした、「保存された」

3。

D:\code\gt2>git status
# On branch master
# Changes to be committed:
#   (use "git reset HEAD <file>..." to unstage)
#
#       new file:   b
#

（ステージを解除するには「git reset HEAD ...」を使用）

• この時点でコードをコミットしました
• 今、あなたはあなたのコミットへのポインタをリセットすることができます ' 最後の保存に戻る '

誰もgit reflog（http://git-scm.com/docs/git-reflog）に言及していないことに驚いています：

# git reflog
<find the place before your staged anything>
# git reset HEAD@{1}

reflogは、リポジトリへの変更を追跡するだけでなく、ユーザーアクション（プル、別のブランチへのチェックアウトなど）も追跡し、それらのアクションを元に戻すことができるgit履歴です。したがって、誤ってステージングされたファイルのステージングを解除する代わりに、ファイルをステージングしなかったポイントに戻すことができます。

これは git reset HEAD <file>いますが、特定のケースではより詳細な場合があります。

申し訳ありませんが、実際にはあなたの質問に答えるのではなく、私が頻繁に使用するファイルをアンステージングする別の方法を示しているだけです（私はRyan Stewartによる回答と非常に不機嫌です）;）お役に立てば幸いです。

ただ使用する：

git reset HEAD <filename>

これにより、ファイルのステージが解除され、変更内容が保持されるため、必要に応じてブランチを変更し、git addそれらのファイルを別のブランチに変更できます。すべての変更が保持されます。

OS がバージョン管理を削除せずにディレクトリからファイルを削除するのと同じように、git rm --cached <file>プレーンからgit rm <file>両方を実行するディレクトリからファイルを削除せずに、インデックスからファイルを削除するように思えますrm <file>。

バージョン2.23以上の場合のみ、

これらの提案の代わりgit restore --staged <file>にunstage、ファイルを順番に使用できます 。