はじめに
株式会社Good Labでエンジニアをしている コータロー です。
日々、Java・SQL・Gitなどの技術情報や、新人エンジニア向けの学習ノウハウ、
AI活用についての情報を発信しています。
Good Labについて気になった方は、コーポレートサイトもぜひご覧ください。
▶コーポレートサイト
この記事は 「図解でわかるGitの仕組み」シリーズ の第4回です。
Gitの内部構造を、1テーマ1記事で図解していきます。
チーム開発で Git を使い始めると、git push や git pull を何気なく実行する場面が増えます。しかし、「これらのコマンドが実際に何をしているのか」を正確に理解している人は意外と少ないのではないでしょうか。
この記事では、以下のポイントを図解で解説します。
- ローカルリポジトリとリモートリポジトリの関係
-
originとは何か -
git push/git fetch/git pullの仕組み - リモート追跡ブランチ(
origin/main)の役割 -
git cloneの裏側で起きていること
対象読者
-
git add/git commit/git pushは使ったことがある - 「
originって何?」と聞かれると自信がない -
fetchとpullの違いがあいまい - リモートリポジトリの仕組みを正確に理解したい
1. ローカルリポジトリとリモートリポジトリ
全体像
Git は 分散型バージョン管理システム です。各開発者のマシンに完全なリポジトリのコピー(ローカルリポジトリ)があり、GitHub 等のサーバー上にあるリポジトリ(リモートリポジトリ)と同期して共同作業を行います。
【図解: ローカルとリモートの全体像】
┌──────────────────────────────────────────────┐
│ リモートリポジトリ(GitHub) │
│ │
│ main: A ── B ── C ── D │
│ │
└─────────────┬────────────────┬───────────────┘
│ │
push / fetch push / fetch
│ │
┌─────────────▼──────┐ ┌──────▼───────────────┐
│ ローカル(開発者A) │ │ ローカル(開発者B) │
│ │ │ │
│ main: A ── B ── C │ │ main: A ── B ── C │
│ (作業中) │ │ feature: A ── B ── E │
└────────────────────┘ └──────────────────────┘
重要なポイントは以下の通りです。
- ローカルリポジトリは完全なコピー であり、コミット履歴をすべて持っている
- ネットワーク接続がなくても
commit、log、branch等の操作が可能 - リモートとの同期は
push/fetch/pullで 明示的に 行う
リモートリポジトリの実体
リモートリポジトリは特別なものではなく、Git リポジトリの一種です。GitHub や GitLab はこのリポジトリをホスティングし、Web UI やアクセス制御を提供しているにすぎません。
技術的には、リモートリポジトリは ベアリポジトリ(bare repository) として構成されています。これはワークツリーを持たず、.git/ ディレクトリの中身だけで構成されたリポジトリです。
# ベアリポジトリの作成(参考)
git init --bare my-project.git
2. origin とは何か
リモートの名前
origin は リモートリポジトリに付けられたデフォルトの名前(エイリアス) です。URL そのものではありません。
# リモートの一覧を表示
git remote
# 出力: origin
# URL も含めて表示
git remote -v
# 出力:
# origin https://github.com/user/my-project.git (fetch)
# origin https://github.com/user/my-project.git (push)
【図解: origin はリモートの名前】
「origin」= リモートリポジトリの URL に付けた名前
┌─────────────────────────────────────┐
│ ローカルリポジトリ │
│ │
│ リモート設定(.git/config): │
│ ┌─────────────────────────────────┐│
│ │ [remote "origin"] ││
│ │ url = https://github.com/...git ││
│ │ fetch = +refs/heads/*: ││
│ │ refs/remotes/origin/* ││
│ └─────────────────────────────────┘│
└─────────────────────────────────────┘
│
│ "origin" という名前で
│ この URL を参照
▼
┌─────────────────────────────────────┐
│ https://github.com/user/my-project │
│ (リモートリポジトリ) │
└─────────────────────────────────────┘
origin は変更可能
origin は慣例的なデフォルト名であり、変更や追加が可能です。
# リモートの名前を変更
git remote rename origin github
# 複数のリモートを登録
git remote add upstream https://github.com/original/project.git
git remote add origin https://github.com/my-fork/project.git
フォークして開発する場合、origin(自分のフォーク)と upstream(元のリポジトリ)の2つを登録するのが一般的です。
3. リモート追跡ブランチ
origin/main とは何か
origin/main は リモート追跡ブランチ(remote-tracking branch) と呼ばれ、「リモートの main ブランチが最後に確認した時点でどこを指していたか」を記録したものです。
【図解: 3種類のブランチ】
┌──────────────────────────────────────────────┐
│ ローカルリポジトリ内の3種類の参照 │
│ │
│ 1. ローカルブランチ : main │
│ → 自分で commit すると進む │
│ │
│ 2. リモート追跡ブランチ : origin/main │
│ → fetch / pull で更新される │
│ → 直接 commit できない(読み取り専用) │
│ │
│ 3. リモートのブランチ(実体): GitHub 上の main │
│ → push で更新される │
└──────────────────────────────────────────────┘
重要な性質は以下の通りです。
-
リモート追跡ブランチは自動的に管理される ---
git fetchやgit pull実行時に Git が自動で更新する - 直接コミットはできない --- チェックアウトしようとすると detached HEAD になる
- ローカルブランチとリモートの橋渡し役 として機能する
確認方法
# リモート追跡ブランチの一覧
git branch -r
# 出力例:
# origin/main
# origin/develop
# origin/feature/login
# ローカルブランチとリモート追跡ブランチの両方を表示
git branch -a
# 出力例:
# * main
# develop
# remotes/origin/main
# remotes/origin/develop
# remotes/origin/feature/login
ローカルブランチとの追跡関係
ローカルブランチは、対応するリモート追跡ブランチを 上流ブランチ(upstream branch) として設定できます。
# 上流ブランチの設定(push 時に -u オプション)
git push -u origin main
# 追跡関係の確認
git branch -vv
# 出力例:
# * main a1b2c3d [origin/main] 最新のコミットメッセージ
# develop e4f5g6h [origin/develop: ahead 2] ローカルが2コミット先行
ahead 2 は「ローカルにリモートより2つ多くコミットがある(まだ push していない)」ことを意味します。behind 3 なら「リモートに3つ新しいコミットがある(まだ pull していない)」を意味します。
4. git fetch --- リモートの情報を取得する
仕組み
git fetch は リモートリポジトリから最新のコミットやブランチ情報を取得し、リモート追跡ブランチを更新する コマンドです。ローカルブランチやワークツリーには一切影響しません。
【図解: git fetch の動作】
[実行前]
リモート(GitHub) ローカル
main: A ── B ── C ── D main: A ── B ── C
origin/main: A ── B ── C
git fetch
─────────────────→
[実行後]
リモート(GitHub) ローカル
main: A ── B ── C ── D main: A ── B ── C ← 変化なし
origin/main: A ── B ── C ── D ← 更新された
ポイントを整理します。
- リモートの新しいコミット(D)がダウンロードされる
-
origin/mainが更新される(C → D) - ローカルの
mainは変化しない - ワークツリーのファイルも変化しない
コマンド例
# すべてのリモート追跡ブランチを更新
git fetch
# 特定のリモートだけ fetch
git fetch origin
# 特定のブランチだけ fetch
git fetch origin main
# リモートで削除されたブランチの参照もクリーンアップ
git fetch --prune
fetch 後の確認
# リモートとの差分を確認
git log main..origin/main --oneline
# → ローカルの main にはないが origin/main にはあるコミット一覧
git log origin/main..main --oneline
# → origin/main にはないがローカルの main にはあるコミット一覧
# 差分の内容を確認
git diff main origin/main
5. git push --- ローカルの変更をリモートに送る
仕組み
git push は ローカルブランチのコミットをリモートリポジトリに送信し、リモートのブランチを更新する コマンドです。
【図解: git push の動作】
[実行前]
ローカル リモート(GitHub)
main: A ── B ── C ── D main: A ── B ── C
origin/main: A ── B ── C
git push origin main
──────────────────────→
[実行後]
ローカル リモート(GitHub)
main: A ── B ── C ── D main: A ── B ── C ── D ← 更新された
origin/main: A ── B ── C ── D ← 同時に更新される
push 成功時、リモート追跡ブランチ(origin/main)も自動で更新されます。
push が拒否されるケース
リモートにローカルにないコミットがある場合、push は 拒否(rejected) されます。
【図解: push が拒否されるケース】
ローカル リモート(GitHub)
main: A ── B ── D main: A ── B ── C
↑
他の開発者が push した
git push origin main
──────────────────────→ ❌ rejected!
(fast-forward できない)
解決策: 先に fetch + merge(または pull)してから push する
ローカル
main: A ── B ── D
↘
merge ← git pull で C を取り込む
↗
C ──
main: A ── B ── D ── C ── M(マージコミット)
git push origin main
──────────────────────→ ✅ 成功
コマンド例
# 基本的な push
git push origin main
# 上流ブランチを設定しつつ push(初回推奨)
git push -u origin main
# 上流ブランチ設定済みなら省略可能
git push
# 新しいブランチをリモートに作成
git push -u origin feature/login
6. git pull --- fetch + merge
仕組み
git pull は、内部的に git fetch + git merge を実行するコマンドです。
【図解: git pull = git fetch + git merge】
[実行前]
リモート(GitHub) ローカル
main: A ── B ── C ── D main: A ── B ── C
origin/main: A ── B ── C
git pull origin main
←─────────────────────
[ステップ1: fetch(内部処理)]
main: A ── B ── C ← まだ変化なし
origin/main: A ── B ── C ── D ← 更新
[ステップ2: merge(内部処理)]
main: A ── B ── C ── D ← マージされた
origin/main: A ── B ── C ── D
上の例は fast-forward マージ のケースです。ローカルに独自のコミットがない場合、ポインタが単純に前に進みます。
ローカルにも独自コミットがある場合
【図解: pull でマージコミットが発生するケース】
[実行前]
リモート(GitHub) ローカル
main: A ── B ── C ── D main: A ── B ── C ── E
origin/main: A ── B ── C
git pull origin main
←─────────────────────
[実行後]
origin/main: A ── B ── C ── D
main: A ── B ── C ── E
↘ ↗
D ── M(マージコミット)
この場合、D と E を統合するマージコミット M が自動生成されます。コンフリクトが発生した場合は手動で解決が必要です。
git pull --rebase
マージコミットを作らずにリモートの変更を取り込みたい場合は、--rebase オプションを使います。
【図解: git pull --rebase】
[実行前]
リモート ローカル
main: A ── B ── C ── D main: A ── B ── C ── E
git pull --rebase origin main
←─────────────────────
[実行後]
main: A ── B ── C ── D ── E'
↑
E を D の後ろに付け替え
(コミットハッシュは変わる)
--rebase は履歴が一直線になるため見やすくなりますが、コミットハッシュが変わる点に注意が必要です。
コマンド例
# 基本的な pull(fetch + merge)
git pull
# 特定のリモート・ブランチを指定
git pull origin main
# rebase で pull
git pull --rebase
# デフォルトで rebase にする設定
git config --global pull.rebase true
7. git clone の裏側
clone で何が起きているか
git clone は単にファイルをダウンロードしているだけではありません。内部では複数の処理が実行されています。
【図解: git clone の内部処理】
git clone https://github.com/user/my-project.git
内部で行われる処理:
1. mkdir my-project && cd my-project
2. git init
→ 空のローカルリポジトリを作成
3. git remote add origin https://github.com/user/my-project.git
→ リモート "origin" を登録
4. git fetch origin
→ すべてのブランチ・タグ・コミットをダウンロード
→ リモート追跡ブランチ(origin/main, origin/develop ...)を作成
5. git checkout main
→ デフォルトブランチをチェックアウト
→ ローカルブランチ "main" を作成し、origin/main を上流に設定
結果:
┌──────────────────────────────────┐
│ my-project/ │
│ ├── .git/ │
│ │ ├── config ← origin の URL │
│ │ ├── objects/ ← 全コミット │
│ │ └── refs/ │
│ │ ├── heads/main │
│ │ └── remotes/origin/main │
│ ├── src/ │
│ └── README.md │
└──────────────────────────────────┘
clone のオプション
# 基本的な clone
git clone https://github.com/user/my-project.git
# ディレクトリ名を指定
git clone https://github.com/user/my-project.git my-app
# 最新のコミットだけ取得(CI/CD で高速化したい場合)
git clone --depth 1 https://github.com/user/my-project.git
# 特定のブランチだけ clone
git clone --branch develop --single-branch https://github.com/user/my-project.git
8. git remote コマンド
リモートの管理
git remote コマンドで、ローカルリポジトリに登録されたリモートを管理します。
# リモート一覧
git remote
# 出力: origin
# URL 付きで表示
git remote -v
# 出力:
# origin https://github.com/user/my-project.git (fetch)
# origin https://github.com/user/my-project.git (push)
# リモートの詳細情報
git remote show origin
# 出力例:
# * remote origin
# Fetch URL: https://github.com/user/my-project.git
# Push URL: https://github.com/user/my-project.git
# HEAD branch: main
# Remote branches:
# develop tracked
# main tracked
# Local branch configured for 'git pull':
# main merges with remote main
# Local ref configured for 'git push':
# main pushes to main (up to date)
リモートの追加・変更・削除
# リモートを追加
git remote add upstream https://github.com/original/project.git
# リモートの URL を変更
git remote set-url origin https://github.com/user/new-repo.git
# リモートの名前を変更
git remote rename origin github
# リモートを削除
git remote remove upstream
複数リモートの活用例
フォークして開発する場合、2つのリモートを使い分けます。
【図解: 複数リモートの運用(フォーク開発)】
┌──────────────────────────────┐
│ upstream(元のリポジトリ) │
│ https://github.com/org/repo │
│ main: A ── B ── C ── D ── E │
└──────────┬───────────────────┘
│ fork
┌──────────▼───────────────────┐
│ origin(自分のフォーク) │
│ https://github.com/me/repo │
│ main: A ── B ── C │
└──────────┬───────────────────┘
│
┌──────────▼───────────────────┐
│ ローカル │
│ main: A ── B ── C │
│ feature: A ── B ── C ── F │
│ │
│ リモート設定: │
│ origin → 自分のフォーク │
│ upstream → 元のリポジトリ │
└──────────────────────────────┘
# 元のリポジトリの最新を取り込む
git fetch upstream
git merge upstream/main
# 自分のフォークに push
git push origin main
9. 全体像のまとめ
最後に、各コマンドがどこからどこへデータを移動させるかをまとめます。
【図解: push / fetch / pull の全体像】
┌───────────────────────────────────────────────────────────────┐
│ リモートリポジトリ(GitHub) │
│ origin/main │
└──────────┬──────────────────────┬────────────────┬───────────┘
│ │ │
git push git fetch git clone
(ローカル→リモート) (リモート→ローカル) (初回コピー)
│ │ │
│ ▼ │
│ ┌───────────────────┐ │
│ │ リモート追跡ブランチ │ │
│ │ origin/main │ │
│ └────────┬──────────┘ │
│ │ │
│ git merge │
│ (追跡→ローカル) │
│ │ │
│ ▼ │
┌──────────┴───────────────────────────────────────┴───────────┐
│ ローカルブランチ │
│ main │
└──────────────────────────────────────────────────────────────┘
git pull = git fetch + git merge
| コマンド | データの流れ | ローカルブランチへの影響 |
|---|---|---|
git fetch |
リモート → リモート追跡ブランチ | なし |
git push |
ローカルブランチ → リモート | なし |
git pull |
リモート → リモート追跡ブランチ → ローカルブランチ | あり(merge される) |
git clone |
リモート → 新しいローカルリポジトリ | 初回作成 |
よくある疑問
Q1. fetch と pull はどちらを使うべき?
安全性を重視するなら fetch → 差分確認 → merge の2ステップがおすすめです。pull は便利ですが、予期しないマージコンフリクトが発生する可能性があります。
# 安全な手順
git fetch
git log main..origin/main --oneline # 何が変わったか確認
git merge origin/main # 問題なければマージ
Q2. push が rejected されたらどうする?
先にリモートの変更を取り込んでから再度 push します。
# 方法1: pull してから push
git pull origin main
git push origin main
# 方法2: fetch + rebase してから push(履歴を一直線にしたい場合)
git fetch origin
git rebase origin/main
git push origin main
git push --force は原則使わないでください。 他の開発者の作業を破壊する危険があります。
Q3. origin/main と main がずれているか確認するには?
# 上流ブランチとの比較
git status
# 出力例: Your branch is behind 'origin/main' by 3 commits
# 詳細な差分
git log --oneline --left-right main...origin/main
# < はローカルのみ、> はリモートのみのコミット
次回予告
第5回: コンフリクト解消
次回は、マージやリベース時に発生する コンフリクト の仕組みと解消方法を図解します。コンフリクトが「なぜ起きるのか」「何が起きているのか」を理解すると、落ち着いて対処できるようになります。
シリーズ目次
| # | テーマ |
|---|---|
| 1 | Gitの全体像 ― ワークツリー・ステージ・リポジトリの3層構造 |
| 2 | ブランチとHEAD ― 「枝分かれ」の正体を理解する |
| 3 | マージとリベース ― 統合戦略の違いを図で比較 |
| 4 | リモートとローカル ― push/pull/fetchの裏側(この記事) |
| 5 | コンフリクト解消 ― なぜ起きるのか、どう直すのか |
| 6 | reset/revert/checkout ― 「戻す」操作を正しく使い分ける |
| 7 | stash/cherry-pick/rebase -i ― 実務で頼れる便利コマンド |
| 8 | .gitignore・フック・設定 ― Gitをカスタマイズする |
| 9 | Git Flow vs GitHub Flow ― ブランチ戦略の選び方 |
| 10 | トラブルシューティング ― 「やらかした!」を救うコマンド集 |
参考
- Git 公式ドキュメント - git-fetch
- Git 公式ドキュメント - git-push
- Git 公式ドキュメント - git-pull
- Git 公式ドキュメント - git-remote
- Git 公式ドキュメント - git-clone
- Pro Git Book(日本語版)- リモートでの作業
- Pro Git Book(日本語版)- リモートブランチ
「この記事が役に立った」と思ったら、LGTM とストックをお願いします。
@kotaro_ai_lab
AI活用や開発効率化について発信しています。フォローお気軽にどうぞ!