✍️ 필사 모드: Gitマスターガイド — 基礎からrebase、cherry-pick、bisect、worktreeまで

# オブジェクトタイプの確認
git cat-file -t HEAD

# コミットオブジェクトの内容を表示
git cat-file -p HEAD

# treeオブジェクトの探索
git ls-tree HEAD

# 3つの領域間のファイル移動フロー
# Working -> Staging
git add file.txt

# Staging -> Repository
git commit -m "feat: add file"

# Repository -> Working（特定ファイルの復元）
git checkout HEAD -- file.txt

# HEADの参照先を確認
cat .git/HEAD
# ref: refs/heads/main

# ブランチが指すコミットを確認
cat .git/refs/heads/main

# Detached HEAD状態にする
git checkout HEAD~2

# リポジトリの初期化・クローン
git init
git clone https://github.com/user/repo.git

# 変更の確認
git status
git diff                    # unstaged変更
git diff --staged           # staged変更
git diff HEAD               # すべての変更

# ステージング＆コミット
git add -p                  # インタラクティブな部分ステージング
git commit -m "feat: login" # コミット
git commit --amend          # 最後のコミットを修正

# リモート同期
git fetch origin            # リモートの変更のみ取得
git pull --rebase origin main  # fetch + rebase
git push origin feature/login  # プッシュ

# ブランチの作成＆切り替え
git branch feature/auth
git checkout -b feature/auth  # 作成 + 切り替え
git switch -c feature/auth    # Git 2.23以降の推奨方法

# ブランチ一覧
git branch -a               # ローカル＋リモート
git branch --merged          # マージ済みブランチ
git branch -d feature/old    # 安全な削除
git branch -D feature/old    # 強制削除

# リモートブランチの整理
git remote prune origin
git fetch -p

# 現在の変更を保存
git stash
git stash push -m "WIP: login form"

# stash一覧の確認
git stash list

# 復元
git stash pop               # 取り出して削除
git stash apply stash@{0}  # 取り出すが保持

# 特定のファイルだけstash
git stash push -m "partial" -- src/auth.ts

# stashをブランチに変換
git stash branch new-branch stash@{0}

# featureブランチをmainにマージ
git checkout main
git merge feature/auth

# featureブランチでmainの最新変更を取り込む
git checkout feature/auth
git rebase main

# 直近5つのコミットを整理
git rebase -i HEAD~5

# 実用例：PR前のコミット整理
# エディタで以下のように修正
# pick abc1234 feat: add login page
# squash def5678 fix: typo in login
# squash ghi9012 style: adjust padding
# -> 3つのコミットが1つに統合される

# 特定のコミットを取得
git cherry-pick abc1234

# 複数のコミットを一度に
git cherry-pick abc1234 def5678

# 範囲で取得（abcは含まず、defは含む）
git cherry-pick abc1234..def5678

# コミットせずに変更だけ適用
git cherry-pick --no-commit abc1234

# bisect開始
git bisect start

# 現在（バグあり）をbadとしてマーク
git bisect bad

# 正常だったコミットをgoodとしてマーク
git bisect good v2.0.0

# Gitが中間のコミットをチェックアウト -> テスト -> 判定
git bisect good  # または git bisect bad

# 原因コミットが見つかったらリセット
git bisect reset

# テストスクリプトによる自動bisect
git bisect start HEAD v2.0.0
git bisect run npm test

# 新しいworktreeを作成
git worktree add ../project-hotfix hotfix/critical-bug

# worktree一覧の確認
git worktree list

# worktreeの削除
git worktree remove ../project-hotfix

# 新しいブランチを作りながらworktreeを作成
git worktree add -b feature/new-ui ../project-ui

# reflogの確認
git reflog

# 誤ってreset --hardした時の復旧
git reflog
# HEAD@{2}: commit: important feature を見つけたら
git reset --hard HEAD@{2}

# 削除されたブランチの復旧
git reflog
git checkout -b recovered-branch HEAD@{5}

# 特定期間の記録
git reflog --since="2 days ago"

[alias]
    # ステータス＆ログ
    st = status -sb
    lg = log --oneline --graph --decorate --all
    last = log -1 HEAD --stat

    # ブランチ
    co = checkout
    sw = switch
    br = branch -vv
    brd = branch -d

    # コミット
    cm = commit -m
    ca = commit --amend --no-edit
    undo = reset HEAD~1 --mixed

    # diff
    df = diff --stat
    dfc = diff --cached

    # stash
    sl = stash list
    sp = stash pop
    ss = stash push -m

    # クリーンアップ
    cleanup = "!git branch --merged | grep -v '\\*\\|main\\|develop' | xargs -n 1 git branch -d"

[core]
    editor = code --wait
    autocrlf = input          # macOS/Linux
    ignorecase = false
    pager = delta              # deltaペイジャーを使用

[pull]
    rebase = true              # pull時に常にrebase

[push]
    default = current          # 現在のブランチのみpush
    autoSetupRemote = true     # push時にupstreamを自動設定

[init]
    defaultBranch = main

[diff]
    tool = vscode
    colorMoved = default

[merge]
    conflictstyle = diff3      # 3-wayコンフリクト表示
    tool = vscode

[rerere]
    enabled = true             # コンフリクト解決を記憶

# インストール
brew install git-delta

# .gitconfigに追加

[core]
    pager = delta

[interactive]
    diffFilter = delta --color-only

[delta]
    navigate = true
    line-numbers = true
    side-by-side = true

## 変更内容
- 何をなぜ変更したか

## テスト
- [ ] ユニットテストの追加・修正
- [ ] ローカルで動作確認
- [ ] エッジケースの検証

## スクリーンショット（UI変更時）

## 関連Issue
- closes #123

# .github/CODEOWNERS

# コードベース全体
* @team-lead

# フロントエンド
/src/components/ @frontend-team
/src/pages/ @frontend-team

# バックエンドAPI
/src/api/ @backend-team

# インフラ
/terraform/ @devops-team
/k8s/ @devops-team

# セキュリティ上重要なファイル
/src/auth/ @security-team @team-lead

type(scope): description

body（オプション）

footer（オプション）

# 例
git commit -m "feat(auth): add Google OAuth login"
git commit -m "fix(api): handle null response from payment gateway"
git commit -m "docs(readme): update installation instructions"

# Breaking Change
git commit -m "feat(api)!: change response format to JSON:API"

git commit -m ":sparkles: add user profile page"
git commit -m ":bug: fix login redirect loop"
git commit -m ":recycle: refactor database connection pool"
git commit -m ":white_check_mark: add unit tests for auth module"

# インストール
npm install -D @commitlint/cli @commitlint/config-conventional

# commitlint.config.js

module.exports = {
  extends: ['@commitlint/config-conventional'],
  rules: {
    'type-enum': [2, 'always', [
      'feat', 'fix', 'docs', 'style',
      'refactor', 'perf', 'test', 'chore', 'ci'
    ]],
    'subject-max-length': [2, 'always', 72],
  },
};

# sparse-checkoutを有効化
git sparse-checkout init --cone

# 必要なディレクトリのみ指定
git sparse-checkout set packages/frontend packages/shared

# ディレクトリを追加
git sparse-checkout add packages/backend

# 設定の確認
git sparse-checkout list

# 全体を復元
git sparse-checkout disable

# 外部リポジトリを追加
git subtree add --prefix=libs/shared-utils \
  https://github.com/org/shared-utils.git main --squash

# 変更を取り込む
git subtree pull --prefix=libs/shared-utils \
  https://github.com/org/shared-utils.git main --squash

# 変更をプッシュバック
git subtree push --prefix=libs/shared-utils \
  https://github.com/org/shared-utils.git main

# Nx：影響を受けたプロジェクトのみテスト
npx nx affected --target=test --base=main --head=HEAD

# Turborepo：変更されたパッケージのみビルド
npx turbo run build --filter=...[HEAD~1]

# GitHub Actionsでの変更検知
# CIでmainと比較し、変更されたパッケージのみ処理

# 1. reflogで元のコミットを見つける
git reflog show origin/main

# 2. 元のコミットに復旧
git push origin HEAD@{1}:main --force

# 3. チームに通知
# 「mainブランチが復旧されました。git pull --rebaseを実行してください」

# mainブランチのforce pushをブロック（GitHub Settings）
# Settings -> Branches -> Branch protection rules
# 「Restrict force pushes」を有効化

# BFGのインストール
brew install bfg

# 特定ファイルを履歴から完全に削除
bfg --delete-files secrets.env

# 特定テキストの置換
bfg --replace-text passwords.txt

# クリーンアップ
git reflog expire --expire=now --all
git gc --prune=now --aggressive

# 強制プッシュ
git push --force

# Git LFSのインストールと初期化
brew install git-lfs
git lfs install

# 追跡するファイルパターンを指定
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "assets/videos/*"

# .gitattributesが自動生成される -- コミットが必要
git add .gitattributes
git commit -m "chore: configure Git LFS tracking"

# LFS追跡ファイルの一覧
git lfs ls-files

# すでにコミットされた大容量ファイルをLFSに移行
git lfs migrate import --include="*.psd" --everything

# マージコミット自体をrevert
git revert -m 1 MERGE_COMMIT_SHA

# -m 1：第1の親（main）を基準に戻す
# -m 2：第2の親（feature）を基準に戻す

# 1. reflogを確認（90日以内）
git reflog

# 2. danglingオブジェクトから復旧
git fsck --lost-found

# 3. 最悪の場合：チームメンバーのローカルリポジトリから復旧
# pushを依頼するか、bundleで受け取る
git bundle create backup.bundle --all