rebase を使用して変更を適用する

2025-08-26

Azure DevOps Services |Azure DevOps Server 2022 |Azure DevOps Server 2020

Visual Studio 2019 |Visual Studio 2022

Git では、新しい各コミットを先行コミットにリンクすることで、ブランチでの開発の履歴が自動的に保持されます。あるブランチを別のブランチにマージすると、履歴の単純性が低下する可能性があります。たとえば、早送りなしのマージでは、複数の先行タスクを含むマージコミットを作成することで、開発の異なる行が結合されます。逆に、Git リベースでは、マージコミットを作成せずにさまざまな開発ラインが結合されるため、コミット履歴は単純になりますが、マージに関する情報は失われます。マージの種類の選択は、マージのレコードを保持するか、コミット履歴を簡略化するかによって影響を受ける可能性があります。

この記事では、高速転送なしのマージではなくリベースを使用する場合について説明し、次のタスクの手順について説明します。

ローカルブランチのリベース
リベース後にローカルブランチを強制的にプッシュする
ローカルコミットをスカッシュするための対話型リベース

Git ワークフローの概要については、 Azure Repos Git チュートリアルを参照してください。

[前提条件]

カテゴリ	Requirements
プロジェクトへのアクセス権	プロジェクトのメンバー。
アクセス許可	- プライベートプロジェクトのコードを表示する: 少なくとも Basic アクセス。 - プライベートプロジェクトのコードを複製または投稿する: 共同作成者セキュリティグループのメンバー、またはプロジェクト内の対応するアクセス許可。 - ブランチまたはリポジトリのアクセス許可を設定する: ブランチまたはリポジトリのアクセス許可を管理します。 - 既定のブランチを変更する: リポジトリのポリシーのアクセス許可を編集します。 - リポジトリをインポートする: プロジェクト管理者セキュリティグループのメンバーまたは Git プロジェクトレベルの [リポジトリの作成 ] アクセス許可が [許可] に設定されています。詳細については、「Git リポジトリのアクセス許可を設定する」を参照してください。
サービス	リポジトリが有効になっています。
ツール	Optional. az repos コマンドを使用する: Azure DevOps CLI。

注

パブリックプロジェクトでは、 利害関係者 アクセス権を持つユーザーは、コードの表示、複製、投稿など、Azure Repos へのフルアクセス権を持ちます。

カテゴリ	Requirements
プロジェクトへのアクセス権	プロジェクトのメンバー。
アクセス許可	- コードの表示: 少なくとも基本アクセス。 - コードの複製または投稿: 共同作成者セキュリティグループのメンバー、またはプロジェクト内の対応するアクセス許可。
サービス	リポジトリが有効になっています。

ローカルブランチのリベース

Git リベースは、ソースブランチからのコミットを現在のローカルブランチ (ターゲットブランチ) に統合します。ソースブランチは変更されません。比較のために、Git リベースとその他のマージの種類を次の図に示します。

Git リベースを使用する場合のコミットの前後を示す図。

Git リベースでは、ターゲットブランチのコミット履歴が再シーケンスされるため、すべてのソースブランチコミットが含まれ、最後の共通コミット以降のすべてのターゲットブランチコミットが格納されます。これを表示するもう 1 つの方法は、ソースブランチ履歴の上にターゲットブランチの変更をリベースで再生することです。特に、Git リベースでは、既存のターゲットブランチコミットのシーケンスが変更されます。これは、他のマージ戦略の場合ではありません。上の図では、コミット K' には K と同じ変更が含まれていますが、C ではなくコミット E にリンクするため、新しいコミット ID が含まれています。

リベース中に、ソースブランチの変更がターゲットブランチの変更と競合する場合、 Git はマージの競合を解決するように求められます。リベース中のマージ競合は、マージ中のマージ競合を解決するのと同じ方法で解決できます。

Rebase vs. no-fast-forward merge

Git リベースを行うと、高速なマージ ( 3 方向 または真のマージと呼ばれる) よりも単純だが正確なコミット履歴が得られます。コミット履歴にマージのレコードが必要な場合は、早送りなしのマージを使用します。

機能またはバグ修正ブランチで作業している唯一のユーザーの場合は、リベースを使用して、最近の main ブランチの作業を定期的に統合することを検討してください。この戦略は、他のユーザーによる最近の作業を常に把握し、発生したマージの競合を迅速に解決するのに役立ちます。リベースすることで、最新の main ブランチ作業の上に新しい機能を実装し、線形コミット履歴を維持するのに役立ちます。

Git のリベースとそれを使用するタイミングの詳細については、「 Rebase と merge」を参照してください。

リベースと強制プッシュのガイドライン

以前にプッシュしたローカルブランチをリベースし、既定の Git プッシュコマンドをもう一度実行すると、プッシュは失敗します。既定の Git プッシュコマンドでは、高速マージを適用して、ローカルブランチをリモートブランチに統合します。リベースによってローカルターゲットブランチ内の既存のコミットのシーケンスが変更されるため、そのコマンドはリベース後に失敗します。そのため、リモートの対応するコミットの履歴と一致しなくなります。このシナリオでは、リモートブランチを上書きすることで強制プッシュが成功します。

Git のリベースと強制プッシュは強力なツールですが、使用するかどうかを決定するときは、次のガイドラインに留意してください。

誰も共有ブランチを使用していないと確信している場合を除き、プッシュされて他のユーザーと共有されているローカルブランチをリベースしないでください。リベース後、ローカルブランチは、対応するリモートブランチの履歴と一致しなくなります。
リモートブランチのローカルバージョンが更新されたリモートブランチ履歴と一致しなくなったため、他のユーザーが使用しているリモートブランチにプッシュを強制しないでください。
チームは、リベースと強制プッシュの使用シナリオに同意する必要があります。

ヒント

コラボレーションレビュープロセスの場合は、 pull request を使用して、リモートリポジトリの既定のブランチに新しい作業をマージします。

リベースする方法

Visual Studio 2022 では、Git メニュー、Git の変更、およびソリューションエクスプローラーのコンテキストメニューを使用して、Git バージョン管理エクスペリエンスが提供されます。 Visual Studio 2019 バージョン 16.8 には、 チームエクスプローラー の Git ユーザーインターフェイスも用意されています。詳細については、「 Visual Studio 2019 - チームエクスプローラー 」タブを参照してください。

[ Git] > [ブランチの管理 ] を選択して、[ Git リポジトリ] ウィンドウを 開きます。
[Git リポジトリ] ウィンドウで、ターゲットブランチを右クリックし、[チェックアウト] を選択します。
ソースブランチを右クリックし、[ rebase <target-branch> を選択 <source-branch>。

$Visual Studio の Git リポジトリウィンドウのブランチコンテキストメニューの [Rebase]$リベース$ オプションのスクリーンショット。$
再ベースが成功すると、Visual Studio に確認メッセージが表示されます。

マージの競合が原因でリベースが停止した場合、Visual Studio から通知されます。競合を解決するか、リベースを取り消して、事前リベース状態に戻すことができます。

ソースブランチのコミットをターゲットブランチに統合するには、 git rebase コマンドを実行します。

git rebase <source branch name> <target branch name>

現在のローカルブランチがターゲットブランチの場合は、rebase コマンドを簡略化して次のことができます。

git rebase <source branch name>

リベース中に競合が発生した場合、Git から通知されます。競合を解決してからgit rebase --continueを実行するか、git rebase --abort実行してリベースを元に戻し、事前リベース状態に戻すことができます。

リベース後にローカルブランチを強制的にプッシュする

以前にプッシュしたローカルブランチをリベースすると、後続の既定の Git プッシュは失敗します。代わりに、ローカルブランチを強制的にプッシュして、対応するリモートブランチを上書きして、コミット履歴が一致するようにすることができます。

Warnung

他のユーザーが作業しているブランチを強制的にプッシュしないでください。詳細については、「リベースと強制プッシュのガイドライン」を参照してください。

Visual Studio で強制的にプッシュするには、最初に強制プッシュオプションを有効にする必要があります。

Tools>Options>Source Control>Git グローバル設定に移動します。
[プッシュ --force-with-lease を有効にする] オプションを選択します。

Git プッシュ --force-with-lease フラグは、強制的にプッシュするローカルブランチ内に統合されていないコミットを持つリモートブランチを上書きしないため、 --force フラグよりも安全です。

[ Git の変更 ] ウィンドウで、プッシュボタンを選択してコミットをプッシュします。

$Visual Studio の [Git Changes]$Git の変更$ ウィンドウの上矢印のプッシュボタンのスクリーンショット。$

または、Git メニューから [プッシュ] を選択することもできます。
既定の Git プッシュ操作が失敗した場合、Visual Studio は 失敗したGit-Push ダイアログを起動します。 [強制プッシュ] を選択します。

$Visual Studio の [Git-push failed]$Git プッシュ失敗$ ダイアログのスクリーンショット。$
プッシュが成功すると、Visual Studio に確認メッセージが表示されます。

ヒント

ローカルブランチから同じ名前のリモートブランチに新しいコミットを強制的にプッシュするには:

git push --force-with-lease <remote> <local branch name>

プッシュするブランチがチェックアウトしたブランチである場合は、force push コマンドを簡略化して次のことができます。

git push --force-with-lease <remote>

リモートリポジトリを複製すると、Git によって、複製したリモートリポジトリの URL の短縮形としてエイリアス origin が割り当てられます。 git remote -vを実行して、originエイリアス値を確認します。 originエイリアスを手動で追加するには、git remote add origin <remote repo url>を実行します。 originエイリアスを使用すると、force push コマンドをさらに簡略化できます。

git push --force-with-lease origin

現在のローカルブランチが originのリモートブランチを追跡している場合は、force push コマンドを完全に省略できます。

git push --force-with-lease

ただし、ローカルブランチがリモートブランチを追跡していない場合、完全に省略されたプッシュコマンドは失敗します。 git remote show originを実行して、ブランチの追跡状態を確認します。

ローカルコミットをスカッシュするための対話型リベース

通常、ローカル機能ブランチで新しい機能に取り組む際に、複数のコミットを作成します。新しい機能を発行する準備ができたら、コミット履歴を簡略化するために、それらのコミットを 1 つのコミットに統合することができます。対話型のリベースを使用して、複数のコミットを 1 つのコミットに スカッシュ することができます。

Visual Studio 2022 では、対話型リベイシングはサポートされていません。代わりに Git コマンドラインを使用してください。

対話型リベースを実行するローカルブランチを確認します。
コミットされていない変更をコミット、スタッシュ、または破棄します。
コミット履歴に戻る距離を見積もります。対話型のリベースコマンドを実行するときにスカッシュする特定のコミットを選択するのと同じにする必要はありません。たとえば、最後の 5 つのコミット内でコミットをスカッシュする場合は、次を実行します。
```
git rebase -i HEAD~5
```
Git では、最新のコミットから始まる、最後の 5 つのコミットを一覧表示するエディターが開きます。例えば次が挙げられます。
```
pick 7068b09 Update README network switch section
pick 9d247f7 Update README network controller section
pick 5d7ab9f Fix fiber optic transmitter test
pick 7b43f3f Add network switch test
pick 00859d9 Add network controller test
```
最初の行はそのままにしておきます。後続の行で、コミットをその上の行にマージするには、 pick を squashに変更します。たとえば、上位 2 つのコミットと下位 2 つのコミットを結合するには、コミットリストを次に変更します。
```
pick 7068b09 Update README network switch section
squash 9d247f7 Update README network controller section
pick 5d7ab9f Fix fiber optic transmitter test
pick 7b43f3f Add network switch test
squash 00859d9 Add network controller test
```
エディターを保存して閉じます。その後、マージされたコミットのセットごとに新しいエディターが開き、コミットメッセージを入力するように求められます。コミットセットごとに、コミットメッセージを 1 つのメッセージに圧縮し、エディターを保存して閉じます。前の例では、スカッシュされたコミットは新しいコミットメッセージで圧縮されています。
```
8fcb88f Update README network sections
ac6d3c0 Fix fiber optic transmitter test
f0aadc3 Add two network tests
```
コミット Fix fiber optic transmitter test はスカッシュされませんでしたが、別の先行コミットにリンクするため、新しいコミット ID が与えられます。

対話型リベースの詳細については、 Git リベース対話型モードを参照してください。

注

Azure DevOps ユーザーはマージをスカッシュして、プル要求中にトピックブランチのコミット履歴を要約できます。

次のステップ

チェリーピックを使用して変更をコピーする

次の方法で共有

rebase を使用して変更を適用する

[前提条件]

ローカル ブランチのリベース

Rebase vs. no-fast-forward merge

リベースと強制プッシュのガイドライン

リベースする方法

リベース後にローカル ブランチを強制的にプッシュする

ローカル コミットをスカッシュするための対話型リベース

次のステップ

関連資料

フィードバック

その他のリソース

ローカルブランチのリベース

リベース後にローカルブランチを強制的にプッシュする

ローカルコミットをスカッシュするための対話型リベース