git pull
git pull
概要(サマリー)
git pullは、リモートリポジトリ(GitHubなど)にある最新の変更履歴をダウンロードし、自分のパソコンの今開いているブランチへ取り込むためのGitコマンドである。
複数人のチーム開発や、職場と自宅など複数のパソコンで開発を行う際、他の人がアップロードした最新のプログラムや設定ファイルを自分の手元に取り込み、最新の状態に同期させるために必須のコマンドである。
詳細解説
git pullとは何か(最新の変更を取り込むコマンド)
git pull は、離れた場所にある「共有の倉庫(リモートリポジトリ)」と、自分のパソコンにある「手元の倉庫(ローカルリポジトリ)」のズレを解消するためのコマンドである。
チーム開発では、他のメンバーが書いた最新コードが日々 GitHub などのリモートリポジトリへ プッシュ されている。自分の手元のコードが古いまま開発を続けると、後から合流させるときに矛盾(コンフリクト)が発生して苦労することになる。そのため、開発を始める前や区切りの良いタイミングで、定期的に git pull を実行してコードを最新に保つ。
git pullが裏で行っていること(fetch と merge)
git pull は、まずリモートの最新履歴を取り、そのあと今開いているブランチへ取り込む。
- git fetch:リモートリポジトリから最新の変更履歴だけをローカルへダウンロードする。この段階では、手元のソースコード自体は書き換わらない。
git pullの中でも、この取得だけを先に行う。 - 取り込み:ダウンロードした履歴を、今のブランチに反映する。
履歴の進み方で、取り込み方は変わる。
- リモートだけが進んでいるときは、手元のブランチをその先へ進める(fast-forward)。マージ用の新しいコミットは作らない。
- 手元とリモートの両方に、別々のコミットがあるときは、今のGitの公式ドキュメントではここで止まる。分岐した履歴を自動では合流させない
--ff-onlyが初期設定である。 - 合流させるときは、
git pull --no-rebaseでマージするか、git pull --rebaseで手元のコミットをリモートの先へ乗せ直す。インストール時や設定で、どちらかが既定になっている環境もある。
つまり、git pull は「git fetch のあと、今のブランチへ取り込む」コマンドである。昔の説明でよく見る「必ず fetch のあとに merge する」は、--no-rebase を選んだときの動作である。履歴だけ見て、ファイルはまだ変えたくないときは git fetch だけを使う。
git pullの基本的な使い方(ターミナルでのコマンド実行)
git pull は、作業中のプロジェクトのディレクトリで、ターミナルやコマンドプロンプトを使って次のように実行する。
# origin の main を取得し、今チェックアウトしているブランチへ取り込む
git pull origin main
git pull origin main は、今のブランチが main でなくても実行できる。その場合は、main の内容を作業中のブランチへ取り込む。同じブランチの最新だけが欲しいときは、追跡設定済みなら git pull とだけ打つ。
多くの場合、すでにブランチの追跡設定がされているため、単に git pull と打つだけで最新のコードを取り込める。
# 追跡しているリモートブランチから自動でプルする
git pull
正常に完了すると、どのファイルが何行追加・削除されたかの要約が画面に出力される。
コンフリクト(競合)が発生したときの対処法
git pull を実行した際、リモートリポジトリの変更箇所と、自分がローカルで書き換えた箇所が「同じファイルの同じ行」で衝突していた場合、Gitは自動で合流させることができず、プルが中断される。これを「コンフリクト(衝突・競合)」と呼ぶ。
コンフリクトが発生すると、該当するファイル内に以下のような印が自動で挿入される。
<<<<<<< HEAD
自分がローカルで書き換えた内容
=======
リモートリポジトリ(他者)が書き換えた最新の内容
>>>>>>> 123456789abcdef...
開発者は、この印を目印に「どちらのコードを残すか(あるいは両方をどう組み合わせるか)」を手動で判断してファイルを修正し、再度コミットを行う必要がある。コンフリクトはチーム開発で日常的に発生するため、怖がらずに対処方法を身につけることが重要である。
AIコーディングとの関係
AIコーディング時代において、git pull を適切なタイミングで実行することは、AIに誤った指示を出さないために非常に重要である。
AIに古いコードを読み込ませるリスクの回避
AIに「この機能を追加して」と指示してコードを生成してもらう際、手元のコードが最新(リモートの状態)になっていないと、AIは古いソースコードを前提に新しいロジックを組み立ててしまう。その結果、すでに解決済みのバグが復活したり、他のメンバーが新しく作った関数やクラスと衝突するコードが生成されたりする。
- 対策: 共有リポジトリで作業するときは、AIにファイルを読ませる前に
git pullで手元を最新にしておく。一人で使っていてリモートに新しいコミットがない作業なら、毎回でなくてもよい。
AIを使ったコンフリクトの解決
git pull でコンフリクトが発生した際、初心者は競合の解消(どのコードを残すべきか)に迷うことが多い。このような場合に、コンフリクト箇所をAIに読み込ませて相談すると非常に効果的である。
- 指示の例:「
git pullをしたところ、以下のファイルでコンフリクトが発生しました。HEAD(手元の修正)とリモートの修正内容を比較し、両方の変更意図を壊さないように綺麗に合流させたコードを提案してください。[コンフリクト部分のコードを貼り付け]」
よくある勘違い
git pullはgit cloneと何が違う?
どちらも「リモートリポジトリからコードを取得する」コマンドなので混同しやすいが、使用する場面が異なる。
- git clone:まだ自分のパソコンにプロジェクトのフォルダ(リポジトリ)が全く存在しないときに、「最初の一回だけ」リモートリポジトリを丸ごとダウンロードして開発環境を構築するコマンド。
- git pull:すでに
git cloneして手元にあるプロジェクトフォルダにおいて、「二回目以降」に最新の更新差分だけをダウンロードして反映するためのコマンド。
すでにローカルにフォルダがある状態で git clone を実行すると、「同じ名前のフォルダが既に存在します」とエラーになる。
git pullをすれば競合は絶対に発生しない?
「git pull をこまめに実行していれば、コンフリクト(競合)は絶対に防げる」と考えるのは間違いである。
同時に二人が同じファイルの同じ行を編集している場合、どちらかが先にプッシュし、もう一方がそれをプルした時点で必ずコンフリクトは発生する。
ただし、git pull を頻繁に行うことで、競合が発生した際に「どの部分でズレが生じたか」を小さな差分の段階で早期に検知できるため、修正作業が劇的に楽になるのは事実である。
git pullはいつでも実行してよい?
手元の作業用ファイルに「コミットしていない(保存していない)変更」がある状態で git pull を実行すると、Gitに「未保存の変更が上書きされて消えてしまう可能性があるため、プルできません」と拒否されることがある。
安全に git pull を行うためには、以下のいずれかの状態にしておく必要がある。
- 現在の変更を一度
git commitで保存する。 - git stash を使い、未保存の変更を一時的に別の場所に避難させる。
git checkout .などを使い、手元の不要な変更を完全に破棄する。
安全な状態を確保してからプルを行うのがGit運用の基本である。
まとめ
git pullは、リモートリポジトリの最新の変更内容を手元のローカルリポジトリに反映するコマンド。- 内部では、まず git fetch で履歴を取り、そのあと今のブランチへ取り込む。分岐していると、初期設定では自動ではマージせず止まる。
- 同じ箇所を同時に変更していた場合は「コンフリクト(競合)」が発生し、手動での解決が必要になる。
- 共有リポジトリでは、AIにコードを読ませる前に
git pullで手元を最新にしておくと、古いコードを前提にした提案を減らせる。
情報ソース
より詳しくAIに聞いてみよう
- git pull と git fetch の違いを、初心者にわかりやすく図解を交えるような言葉で説明してください。
- git pull を実行したときに「Already up to date.」と表示されました。これはどういう状態を意味していますか?
- git pull origin main と実行した際、手元のブランチが main ではない場合、どのような動作になりますか?
- VS Code などのエディタを使って、git pull で発生したコンフリクトをGUIで視覚的に解決する手順を教えてください。
- git pull をしようとしたら「Your local changes to the following files would be overwritten by merge」とエラーが出ました。AIコーディングでこのエラーを回避する最も簡単な対処法を教えてください。