GitHub Desktop・作業操作

GitHub Desktopで競合が出た時に確認したいこと

GitHub Desktopでconflictが出た時に、慌てて削除せず確認するポイントを初心者向けに整理します。

このサイトはGitHub公式サイトではありません。GitHubの基本的な使い方や、Codex・ChatGPT時代のコード管理を初心者向けに整理するガイドです。機能・料金・提供状況は変更される可能性があるため、重要な判断ではGitHub公式情報も確認してください。

このページでわかること

最初に結論

競合は、同じ場所に別々の変更が入った時に起きます。慌てて削除せず、どちらの変更を残すべきか確認します。

初心者向け説明

conflictは失敗ではなく、Gitが自動判断できない状態です。ファイルの該当箇所を見て、必要な内容を手で整理してからcommitします。

向いている使い方

  • 共同作業で同じファイルを編集した
  • Codex作業と手作業が重なった
  • pullやmergeで止まった

注意が必要な使い方

  • 競合マーカーをそのまま公開しない
  • 片方を全部消す前に意味を確認する
  • Codexに任せる場合も最終差分を見る

CodexやChatGPTと組み合わせる場合

Codexに競合解消を頼む時は、残したい仕様、消してよい変更、触ってはいけないファイルをはっきり伝えると安全です。

秘密情報・APIキー・パスワード・個人情報の注意

競合箇所に設定値や認証情報が出ている場合は、解消より先に秘密情報の扱いを確認してください。

Fetch・Pull・Mergeが更新する対象

2026年11月18日時点の公式ヘルプでは、GitHub Desktopでリモートのコミットを調べる操作はFetch origin、取得した変更を手元へ取り込む操作はPull originとして案内されています。対象はCurrent Branchで選んだローカルブランチです。Pullによって更新されるのは手元のコピーで、GitHub側へ手元の変更を送るにはpushが別に必要です。別ブランチの変更を現在のブランチへ加える時は、Current Branchから取り込む相手を選んでMergeを実行する流れです。競合がある場合はマージボタンの上に警告が出て、競合を解消するまでは取り込めません。エディタ、コマンドライン、その他のツールで解消する扱いが説明されています。同期先の変更を取り込む操作と、別ブランチを統合する操作は、画面上で対象が異なります。

出典:GitHub『Syncing your branch in GitHub Desktop』(2026年11月18日確認)https://docs.github.com/en/desktop/working-with-your-remote-repository-on-github-or-github-enterprise/syncing-your-branch-in-github-desktop

同じ行の編集と削除されたファイルの競合

2026年11月18日時点の公式ヘルプでは、同じファイルの同じ行に異なる変更がある場合だけでなく、一方でファイルを編集し、他方で同じファイルを削除した場合にも競合が起きます。同じ行の競合では、ファイルに競合マーカーが入り、現在側と取り込み側の内容が区切られます。採用する形は、一方の変更だけを残す方法、他方だけを残す方法、双方の内容を取り入れた新しい文にする方法があります。最終的な内容に整理した後は、競合マーカーを取り除き、解消した変更をステージしてコミットする手順です。削除と編集の競合では、ファイルを残すか削除するかを決める必要があります。こちらは単に二つの文をつなぐ問題とは異なり、ファイル自体を管理対象に残すかという判断です。公式のコマンド例では、競合中のファイルはgit statusのUnmerged pathsに表示されます。both modifiedは双方で編集された状態、deleted by usは現在側で削除された状態を示す例です。同じ競合という表示でも、状態の種類によって残す対象が変わります。解消内容をコミットした後に、リモートへのpushやPRのマージへ進む順序が示されています。

出典:GitHub『Resolving a merge conflict using the command line』(2026年11月18日確認)https://docs.github.com/en/pull-requests/how-tos/merge-and-close-pull-requests/resolving-a-merge-conflict-using-the-command-line

ブラウザの競合エディタで処理する範囲

2026年11月18日時点の公式ヘルプでは、GitHub上の競合エディタは、行の変更が競合する単純なケースを扱う機能です。それ以外の競合はコマンドラインで処理する方法が案内されています。GitHub上で競合を解消すると、ベースブランチ全体がヘッドブランチへマージされます。画面で対立していた数行だけを選ぶ操作に見えても、取り込みの対象はその数行だけではありません。ヘッド側が既定ブランチや保護ブランチの場合、新しいヘッドブランチの作成を求められることがあります。操作するPull Requestのbaseとheadの関係が、取り込みの方向を読む情報になります。Desktopからブラウザへ移って解消する場面でも、どちらの枝へ変更が入るのかは、PRに表示されたブランチで判断する内容です。

出典:GitHub『Resolving a merge conflict on GitHub』(2026年11月18日確認)https://docs.github.com/en/pull-requests/how-tos/merge-and-close-pull-requests/resolving-a-merge-conflict-on-github

rebaseの中断・スキップ・続行は別の操作

2026年11月18日時点の公式ヘルプでは、rebaseで競合が起きると、適用できなかったコミットがエラーに示されます。対処には中断、対象コミットのスキップ、競合の修正という選択肢があります。git rebase --abortはrebase前のブランチの状態へ戻す操作です。git rebase --skipは問題のコミットを丸ごと飛ばすため、そのコミットが導入した変更は含まれなくなります。競合箇所を直して処理を継続する時はgit rebase --continueを使う手順です。skipは警告だけを消すためのボタンではなく、取り込まれる変更の集合を変える操作です。通常のマージの途中なのか、rebaseが止まっているのかによって、続行するための操作も変わります。

出典:GitHub『Resolving merge conflicts after a Git rebase』(2026年11月18日確認)https://docs.github.com/en/get-started/using-git/resolving-merge-conflicts-after-a-git-rebase

解消後の差分を前後の文脈まで表示する

2026年11月18日時点の公式ヘルプでは、GitHub Desktopの差分表示にUnifiedとSplitがあり、Splitは変更前を左、変更後を右に並べます。行番号の近くの矢印から変更の前後を広げられ、差分上のメニューにあるExpand Whole Fileではファイル全体を表示できます。空白の変更を隠す設定も別に用意されています。競合を解消した箇所の前後を読む場合は、表示を広げる操作と、ファイル内容を編集する操作を分けて扱えます。コミットへ含めるファイルや行は選択式で、ファイルを保存しただけでは、すべてが同じコミットに入るとは限りません。解消内容の表示とコミット対象の選択が、Desktop上ではそれぞれの確認対象です。

出典:GitHub『Committing and reviewing changes to your project in GitHub Desktop』(2026年11月18日確認)https://docs.github.com/en/desktop/making-changes-in-a-branch/committing-and-reviewing-changes-to-your-project-in-github-desktop

関連ページ

FAQ

GitHub Desktopで競合が出た時に確認したいことは初心者でも確認できますか?

はい。専門用語を覚える前に、何を確認すればよいかを優先して整理しています。

CodexやChatGPTを使う場合も同じ考え方ですか?

基本は同じです。自動化できる部分が増えても、差分確認、秘密情報確認、公開前確認は人間側で見ます。

秘密情報が混ざったかもしれない時はどうしますか?

commitやpushを急がず、対象ファイル、公開範囲、履歴への混入有無を確認します。必要に応じてキーやパスワードを無効化します。

GitHubの機能や画面は変わりますか?

変わる可能性があります。重要な判断や最新仕様はGitHub側の情報も確認してください。

このカテゴリの親ハブ

関連ページをまとめて確認する場合は、GitHub Desktopハブ から読み進められます。