ブランチ運用の実践 | Git レッスン5

🎯 このレッスンで学ぶこと

• ブランチの命名規則（feature/, fix/ など）を使い分けられます。
• git switch でブランチを切り替えられます。
• 不要なブランチを削除できます。
• 「main は常に動く状態」のルールを理解できます。

📖 復習 — ブランチの基本をおさらい

• git checkout -b ブランチ名 でブランチを作成・切り替えできる
• git merge ブランチ名 で変更を統合できる
• Pull Request でチームメンバーにレビューしてもらう

今回はブランチをもっと実践的に使いこなす方法を学びます。

📝 1. ブランチの命名規則

チーム開発では、ブランチ名を見ただけで「何のための作業か」がわかるように命名規則を使います。

良い例・悪い例:

🔀 2. git switch — 新しい切り替えコマンド

git switch はブランチの切り替え専用コマンドです。git checkout より安全で分かりやすいです。

# ブランチを切り替える
git switch main

# 新しいブランチを作成して切り替える（-c = create）
git switch -c feature/add-login

# 全ブランチを一覧表示（今いるブランチに * がつく）
git branch -a

ターミナル出力例:

$ git switch -c feature/add-login
Switched to a new branch 'feature/add-login'

$ git branch
  main
* feature/add-login

🗑️ 3. ブランチの削除

マージが完了したブランチは削除して整理しましょう。

# マージ済みのブランチを削除（安全）
git branch -d feature/add-login

# 未マージでも強制削除（注意！）
git branch -D feature/experiment

🌊 4. ブランチ運用のルール

チーム開発で守るべき3つのルールです。

• ① main は常に動く状態を保つ — main ブランチは「いつでも正常に動くコード」だけを置く場所。壊れたコードを直接 main に入れない
• ② 1つの機能 = 1つのブランチ — 「ログイン機能」と「デザイン変更」を同じブランチで作業しない。分けることでレビューしやすくなる
• ③ 小さく分けてこまめにコミット — 大きな変更を一気にコミットせず、小さな単位で記録する。問題が起きたとき戻しやすい

❌ 悪い例 — 1つのブランチに複数の作業を混ぜた場合:

$ git log --oneline
a3f2c1d ヘッダーのデザイン変更
b4e1d2a ログイン機能を追加
c5f3e4b フッターの色を修正
d6a4f5c READMEを更新

↑ 何の機能のブランチかわからない。レビューも大変になります。

💻 やってみよう！

以下の手順で、ブランチの作成→作業→マージ→削除の一連の流れを体験しましょう。

1. 既存のリポジトリで main ブランチにいることを確認

   git branch

2. 新しいブランチを作成して切り替え

   git switch -c feature/add-contact

   期待される出力:

   $ git switch -c feature/add-contact
   Switched to a new branch 'feature/add-contact'

3. ファイルを追加してコミット

   echo "お問い合わせページ" > contact.html
   git add contact.html
   git commit -m "お問い合わせページを追加"

   期待される出力:

   $ git commit -m "お問い合わせページを追加"
   [feature/add-contact 1a2b3c4] お問い合わせページを追加
    1 file changed, 1 insertion(+)
    create mode 100644 contact.html

4. main に戻ってマージ

   git switch main
   git merge feature/add-contact

5. マージ済みブランチを削除

   git branch -d feature/add-contact

   期待される出力:

   $ git branch -d feature/add-contact
   Deleted branch feature/add-contact (was 1a2b3c4).

git log --oneline でコミット履歴を確認してみましょう！

⚠️ よくあるミス

• main にいるつもりで別ブランチだった — 作業前に git branch で現在のブランチを確認しましょう。プロンプトにブランチ名を表示する設定もおすすめです。
• 日本語ブランチ名を使ってしまった — git switch 田中の作業 はエスケープが必要でエラーの原因に。必ず半角英数字で命名しましょう。
• コミットせずにブランチを切り替えた — 変更が別ブランチに持ち越されます。切り替え前に git status で未コミットの変更がないか確認しましょう。

🛠️ 差分を視覚的に確認するツールでブランチ間の変更を比較できます。