◀ 6.

git pull でローカルをリモートに同期する方法と注意点（fetch + merge の違いまで）

▶
編集
この記事の要点
  • git pull origin main でリモート最新をローカルに取り込み
  • pull は内部的に git fetch + git merge（または rebase）
  • 未コミット変更がある状態で pull すると競合する → 事前に git stash or commit
  • マージコミットを作りたくない場合は git pull --rebase
  • コンフリクトが出たら <<<<<<< ===== >>>>>>> マーカーを編集 → git add → git commit

基本: git pull コマンド

リモートリポジトリの最新変更をローカルブランチに取り込む基本コマンド:

# リモート (origin) の main ブランチをローカル main にマージ
git pull origin main

# upstream が設定済なら省略可
git pull

# rebase で取り込む（マージコミット作らない）
git pull --rebase

# fast-forward only（マージできなければエラー）
git pull --ff-only

git pull の中身: fetch + merge

git pull は実は 2 つのコマンドの組み合わせです:

# git pull origin main は内部的に以下と同じ
git fetch origin main      # リモート最新を取得（ローカルブランチには反映しない）
git merge origin/main      # 取得した内容を現在のブランチにマージ

# --rebase オプションの場合
git fetch origin main
git rebase origin/main

動作の違い:

コマンド動作ローカル変更
git fetchリモート最新を取得のみ影響なし（安全）
git pullfetch + merge現在のブランチに自動マージ
git pull --rebasefetch + rebaseローカルコミットをリモートの上に積み直す

典型的な作業フロー

# 1. 作業前にリモート最新を取り込む
git checkout main
git pull origin main

# 2. ブランチを切って作業
git checkout -b feature/new-login
# ... 編集・コミット ...
git add .
git commit -m "Add login feature"

# 3. push 前にリモート最新を取り込む（コンフリクト早期検知）
git pull --rebase origin main

# 4. push
git push origin feature/new-login

未コミット変更があるときの pull

ローカルに未コミット変更があり、リモート最新が同じファイルを変更している場合 → pull できません:

error: Your local changes to the following files would be overwritten by merge:
    src/Login.php
Please commit your changes or stash them before you merge.
Aborting

対処2 通り:

# 方法 A: stash で一時退避
git stash                    # 変更を退避
git pull origin main         # pull
git stash pop                # 退避を戻す（コンフリクト出る可能性あり）

# 方法 B: 先にコミット
git add .
git commit -m "WIP: 作業中"
git pull --rebase origin main  # rebase で履歴を直線化

コンフリクトが出たとき

同じファイルの同じ行を両者が変更していた場合、Git は自動マージできずコンフリクトになります:

Auto-merging src/Login.php
CONFLICT (content): Merge conflict in src/Login.php
Automatic merge failed; fix conflicts and then commit the result.

該当ファイルを開くと:

<<<<<<< HEAD
$user = User::find($id);      // ← ローカルの変更
=======
$user = User::findOrFail($id); // ← リモートの変更
>>>>>>> origin/main

解決手順:

# 1. ファイルを編集してマーカーを削除
# どちらか or 両方を残す形に修正

# 2. 解決済としてマーク
git add src/Login.php

# 3. マージコミット作成（merge の場合）
git commit
# rebase 中の場合
git rebase --continue

# rebase をやめたい場合
git rebase --abort

# merge をやめたい場合
git merge --abort

pull の代わりに fetch + merge を分けて実行

慣れてくるとpull せずに fetch + mergeを分けて実行する方が安全と気付きます:

# 1. リモートを取得（ローカルブランチには影響なし）
git fetch origin

# 2. 差分を確認
git log HEAD..origin/main --oneline
git diff HEAD origin/main

# 3. 安全と判断したらマージ
git merge origin/main
# または rebase
git rebase origin/main

よくあるトラブル

症状原因対処
fatal: refusing to merge unrelated histories履歴が無関係のリポジトリgit pull --allow-unrelated-histories
error: pathspec 'main' did not matchリモートに main ブランチが無い（master の可能性）git pull origin master
毎回マージコミットが増えるpull がデフォルト mergegit config --global pull.rebase true
Your branch is ahead of 'origin/main' by N commitspush 忘れgit push

FAQ

Q: pull と fetch、どちらを使うべき？
A: 初心者は pull、慣れたら fetch + merge を分けると安全です。チームで運用するなら pull --rebase を推奨。

Q: pull で勝手にマージコミットができるのを防ぎたい
A: git config --global pull.rebase true で常に rebase 動作。または git config --global pull.ff only で fast-forward only。

Q: 強制的にリモートと同じ状態にしたい（ローカル変更全捨て）
A: git fetch origin && git reset --hard origin/main。未コミット変更は消えるので注意。

編集
Post Share
子ページ

子ページはありません

同階層のページ
  1. 用語一覧
  2. エラー一覧
  3. git本体のインストール(Linux)
  4. Linuxサーバーへのgit導入とクライアントのセットアップ
  5. リモートリポジトリをローカルリポジトリとしてクローンする方法
  6. リモートとローカルのリポジトリを同期(pull)する方法
  7. 設定の確認
  8. gitユーザー名とemailの設定
  9. リモートリポジトリの作成
  10. ローカルリポジトリの作成
  11. 新規ファイル/ディレクトリをインデックスに登録
  12. インデックスの登録状態を確認
  13. ローカルリポジトリの変更をコミット
  14. コミット履歴の確認
  15. クライアントからリモートリポジトリの接続設定、確認、削除
  16. リポジトリへのプッシュ
  17. リモートリポジトリからクライアントへのSSHクローン
  18. リモートとローカルの差分表示
  19. バージョンの確認
  20. プロキシの設定
  21. ローカルをリモートリポジトリの状態に戻す
  22. ブランチの作成, 一覧表示, 切り替え
  23. ブランチのマージと削除
  24. リベース
  25. .gitignoreの書き方
  26. .gitignoreの設定が反映されない場合
  27. 特定のファイルをgitの管理から外す方法
  28. 参照(ORIG_HEAD, HEAD, FETCH_HEAD)
  29. git rm [-r --cached] の取り消し
  30. 一部のディレクトリ/ファイルのみをリポジトリから復元する方法
  31. ローカルとリモートリポジトリの有無を同期
  32. pushの取消し方法
  33. マージツールの起動方法
  34. Gitで「MERGING」の状態a
2026-05-16 16:49:32 T 994

人気ページ

最近更新/作成されたページ