Git & GitHub 完全ガイド

中級：チーム開発（2〜5人）

ブランチとプルリクエストを使ったチーム開発のワークフローです。

例3：友達とWebアプリを開発

あなた＝バックエンド担当、友達＝フロントエンド担当

# === あなたの作業（バックエンド） ===
git clone https://github.com/team/todo-app.git
cd todo-app

# フィーチャーブランチを作成
git switch -c feature/api-endpoints

# APIを開発
git add server.py routes.py
git commit -m "feat: タスクCRUDエンドポイントを追加"

git add database.py
git commit -m "feat: SQLiteデータベース連携を追加"

# プッシュしてPRを作成
git push -u origin feature/api-endpoints

# GitHubでPull Requestを作成
# レビュー後にマージ

# ローカルをクリーンアップ
git switch main
git pull origin main
git branch -d feature/api-endpoints

例4：バグ報告への対応

ユーザーから「ログイン画面がモバイルでクラッシュする」との報告

# 最新のmainから開始
git switch main
git pull origin main

# バグ修正ブランチを作成
git switch -c bugfix/login-mobile-crash

# バグを調査して修正
git add login.css login.js
git commit -m "fix: モバイルでのログイン画面クラッシュを修正

ログインフォームのコンテナが固定幅だったため、
375px未満の画面でオーバーフローしていた。
max-widthとパーセント指定に変更。

Fixes #87"

# プッシュしてPRを作成
git push -u origin bugfix/login-mobile-crash

例5：コンフリクトの解決

# マージしようとしたらコンフリクト発生！
git switch main
git merge feature/update-config
# CONFLICT: Merge conflict in config.py

# config.pyを開くとこんな表示：
# <<<<<<< HEAD
# DATABASE_URL = "postgresql://localhost/myapp_v2"
# =======
# DATABASE_URL = "postgresql://localhost/myapp_production"
# >>>>>>> main

# チームメイトと相談して正しい方を残す
# マーカー（<<<, ===, >>>）を全て削除

git add config.py
git commit -m "fix: config.pyのコンフリクト解決、本番DB URLを使用"

上級：プロダクション環境 & オープンソース

例6：CI/CD付きの本格的な機能開発

# === 朝：機能開発の開始 ===
git switch main
git pull origin main
git switch -c feature/payment-integration

# === 小さなコミットで段階的に開発 ===
git add models/payment.py
git commit -m "feat: Stripe用の決済モデルを追加"

git add services/payment_service.py
git commit -m "feat: Stripe SDK使用の決済処理サービスを追加"

git add tests/
git commit -m "test: 決済システムのテストを追加"

# === PR前の整理 ===
git fetch origin
git rebase origin/main

# プッシュ（リベース後はforce-with-leaseが必要）
git push --force-with-lease origin feature/payment-integration

# CI/CDパイプラインが自動実行：
# ✅ リンター通過
# ✅ ユニットテスト通過
# ✅ セキュリティスキャン通過

# レビュー承認後、マージ

例7：オープンソースへの貢献

# === ステップ1：フォークしてクローン ===
# GitHubで「Fork」ボタンをクリック
git clone https://github.com/あなた/cool-library.git
cd cool-library

# 本家リポジトリを「upstream」として追加
git remote add upstream https://github.com/本家/cool-library.git

# === ステップ2：同期を保つ ===
git fetch upstream
git switch main
git merge upstream/main

# === ステップ3：修正ブランチで作業 ===
git switch -c fix/csv-unicode-error
# バグを修正...
git add parser.py
git commit -m "fix: CSVパーサーのUnicode BOM処理を修正"

# === ステップ4：自分のフォークにプッシュ ===
git push -u origin fix/csv-unicode-error

# === ステップ5：本家にPRを作成 ===
# GitHubで base=本家/main ← compare=あなた/fix/csv-unicode-error

例8：本番環境の緊急修正（ホットフィックス）

# === 緊急対応！ ===
git switch main
git pull origin main

# ホットフィックスブランチ作成
git switch -c hotfix/fix-auth-crash

# 最小限の修正（余計な変更はしない！）
git add auth/session.py
git commit -m "hotfix: セッショントークンのnullチェック追加

本番ユーザーが500エラーを受けていた原因は、
期限切れトークンがnullを返す際のチェック漏れ。

Incident: INC-2024-0892"

# 即座にプッシュ → 緊急レビュー → マージ
git push -u origin hotfix/fix-auth-crash

# リリースタグを付ける
git switch main
git pull origin main
git tag -a v2.3.1 -m "Hotfix: 認証クラッシュ修正"
git push origin v2.3.1

例9：リリース管理

# === リリースブランチ作成 ===
git switch develop
git pull origin develop
git switch -c release/v2.0.0

# バグ修正のみ（新機能は追加しない！）
git commit -m "fix: バージョン番号を2.0.0に更新"

# === mainにマージ → タグ付け ===
git switch main
git merge release/v2.0.0
git tag -a v2.0.0 -m "Release v2.0.0"
git push origin main --tags

# === developにもマージ ===
git switch develop
git merge main
git push origin develop