HOWTO · Git

Git ブランチポインターを別のコミットに移動する方法

チェックアウト中の Git ブランチは git reset で、チェックアウトしていない別のブランチは git branch -f または git update-ref で移動します。各コマンドが何を変更するのか、対象コミットをどう選ぶのかを学びます。

このページの内容

Git ブランチポインターを選択したコミットに移動するには、そのブランチがチェックアウトされているときに git reset を使用します。現在のブランチに留まったまま別のブランチを移動するには、git branch -f または git update-ref を使用します。git branch -f は、いずれかのワークツリーでチェックアウトされているブランチの移動を拒否します。git update-ref はインデックスやワーキングツリーを更新せずに参照を直接更新します。チェックアウト中のブランチに使用すると、HEAD が新しいコミットを指す一方で、それらのファイルは以前のコミットのままになる場合があります。以下の <target-commit> は、目的のコミットを識別するコミットハッシュ、タグ、その他のリビジョン式に置き換えてください。

チェックアウト中のブランチを git reset でコミットに移動する

git reset は現在のブランチを選択したコミットに移動します。そのモードは、インデックスとワーキングツリーに何を起こすかによって選択します。ソフトリセットはブランチを移動し、両方をそのままにします。デフォルトの mixed モードはブランチを移動してインデックスを更新し、ワーキングツリーのファイルはそのままにします。ハードリセットはブランチを移動し、インデックスと追跡対象のワーキングツリーファイルを対象コミットに一致させます。

git reset --hard を使用する前に、必要な追跡対象の変更を保存してください。このコマンドは、追跡対象ファイルへの未コミットの変更を破棄する場合があります。追跡対象外のファイルは通常そのままですが、対象コミットからの追跡対象パスの書き込みを妨げる場合、Git がそれらを削除または上書きすることがあります。次の自己完結型の例では、一時リポジトリを作成し、main に 2 つのコミットを作成して、チェックアウト中のブランチを最初のコミットに戻します。

set -eu
repo_dir=$(mktemp -d)
trap 'rm -rf "$repo_dir"' EXIT
cd "$repo_dir"
git init -q -b main
git config user.name Example
git config user.email example@example.com
printf 'first version\n' > note.txt
git add note.txt
git commit -q -m first
first_commit=$(git rev-parse HEAD)
printf 'second version\n' > note.txt
git commit -q -am second
git reset --hard "$first_commit" >/dev/null
printf 'Branch: %s\n' "$(git branch --show-current)"
printf 'Commit: %s\n' "$(git log -1 --format=%s)"
Branch: main
Commit: first

自分のリポジトリでこのコマンドを適用する際は、HEAD~1 のようなリビジョンやコミットハッシュを対象として使用してください。ローカルの追跡対象の変更を保持する必要がある場合は、git reset --soft <target-commit> または git reset --mixed <target-commit> を検討し、コミット前に結果のインデックスとワーキングツリーを確認してください。リセットが変更するのは現在のブランチのみであり、別のブランチ名を直接移動することはありません。

チェックアウトしていない別のブランチをコミットに移動する

チェックアウト中以外のブランチを移動するには、対象ブランチを現在のワークツリーでチェックアウトしない状態に保ちます。git branch -f は、名前付きブランチの参照を選択したコミットに強制的に移動します。たとえば、git branch -f feature <target-commit> は feature をそのコミットに移動します。-f はブランチの現在の先端を意図的に置き換えるため、使用前にブランチ名と対象を確認してください。ワークツリーでチェックアウトされているブランチの移動は拒否します。

ブランチ参照は git update-ref で直接更新することもできます。完全な参照名と、対象コミットに解決されるリビジョンを使用します:git update-ref -m "move feature to target" refs/heads/feature <target-commit>。-m オプションは、指定されたメッセージを reflog に記録します。これにより、後で参照が移動した理由を説明しやすくなります。このタスクでは、feature はチェックアウトされていない別のブランチであるため、どちらのコマンドでも、現在のブランチをチェックアウトしたままそれを移動できます。git branch -f とは異なり、git update-ref はチェックアウト中のブランチでも拒否しません。参照は変更しますが、インデックスとワーキングツリーのファイルには触れません。現在のブランチをこの方法で更新すると、HEAD は新しいコミットに解決されますが、インデックスとファイルは古いものを反映したままであるため、新しいコミットに対して変更されたように見える場合があります。

git checkout -b feature <target-commit> は新しいブランチを作成してチェックアウトします。既存の feature ブランチを移動するものではありません。コミットを直接チェックアウトすると HEAD が分離(detached)します。Rebase には別の目的があります。コミットを新しいベース上に再生し、新しいコミット ID を作成する場合があるため、既存のブランチを任意のコミットに向ける直接的な方法ではありません。チェックアウト中のブランチにはリセットを、チェックアウトしていない別のブランチには上記の参照コマンドのいずれかを選択してください。