Git完全攻略：ジュニアからシニアまで、実務で即使えるGit上級ワークフロー

# ファイル内容のハッシュ値を確認
echo "Hello, Git!" | git hash-object --stdin
# 結果例: af5626b4a114abcb82d63db7c8082c3c4756e51b

# 保存されたオブジェクトのタイプを確認
git cat-file -t af5626b
# 結果: blob

# 内容を確認
git cat-file -p af5626b
# 結果: Hello, Git!

# 最新コミットのツリーを確認
git cat-file -p HEAD^{tree}
# 100644 blob a906cb2a4a904a15...    README.md
# 040000 tree 99f1a6d12cb4b6f1...    src
# 100644 blob 47c6340d6459e058...    package.json

# コミットの内部構造を確認
git cat-file -p HEAD
# tree 99f1a6d12cb4b6f19c8655fca46c3ecf317074e0
# parent 8bd3ad5e1234567890abcdef1234567890abcdef
# author John Doe <john@example.com> 1711100000 +0900
# committer John Doe <john@example.com> 1711100000 +0900
#
# feat: add user authentication

# アノテーティッドタグを作成
git tag -a v1.0.0 -m "Release version 1.0.0"

# タグオブジェクトを確認
git cat-file -p v1.0.0

# 同一の内容 = 同一のハッシュ
echo "same content" | git hash-object --stdin
echo "same content" | git hash-object --stdin
# 二つの結果は完全に同一

    A---B---C---D  (main)
         \
          E---F---G  (feature)
               \
                H---I  (hotfix)

# グラフ形式でログを表示
git log --oneline --graph --all --decorate

# より見やすい出力
git log --oneline --graph --all --format="%h %s (%ar)"

.git/
  HEAD          # 現在のブランチを指すポインタ
  config        # リポジトリ固有の設定
  refs/
    heads/      # ローカルブランチ（各ファイル = コミットハッシュ）
    tags/       # タグ
    remotes/    # リモートブランチの追跡
  objects/      # すべてのGitオブジェクト（blob, tree, commit, tag）
    pack/       # 圧縮されたオブジェクトパックファイル
  hooks/        # Gitフックスクリプト
  index         # ステージングエリア（バイナリ）

# HEADが指す先を確認
cat .git/HEAD
# ref: refs/heads/main

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

# オブジェクトストアのサイズを確認
git count-objects -vH

main ─────────────────────────────── （本番環境）
  │
  └── develop ────────────────────── （開発統合）
        │        │
        │   feature/login ────────── （機能開発）
        │
        └── release/1.0 ──────────── （リリース準備）
              │
              └── hotfix/bug-123 ──── （緊急修正）

# Git Flowの初期化（git-flow拡張）
git flow init

# 機能開発の開始
git flow feature start user-auth

# 機能開発の完了
git flow feature finish user-auth

main ────────────────────────────────
  │              │
  └── feature ───┘ （PR + マージ）

# 1. ブランチ作成
git checkout -b feature/add-search

# 2. 作業とコミット
git add .
git commit -m "feat: add search functionality"

# 3. プッシュ
git push -u origin feature/add-search

# 4. PR作成（GitHub CLI）
gh pr create --title "Add search functionality" --body "..."

# 5. レビュー後マージ
gh pr merge --squash

main ──A──B──C──D──E──F──G──H──I──
            \─/     \─/
         （1-2日） （1-2日）

# 機能開発
feature/JIRA-123-add-login
feature/user-profile-page

# バグ修正
bugfix/JIRA-456-fix-null-pointer
fix/login-redirect-loop

# ホットフィックス
hotfix/security-patch-xss
hotfix/v1.2.1

# リリース
release/1.0.0
release/2026-q1

# 実験/メンテナンス
experiment/new-search-algo
chore/update-dependencies

git checkout main
git merge feature/login
# マージコミットが作成される

    A---B---C---D---M  （main、マージコミットM）
         \         /
          E---F---G  （feature）

git checkout feature/login
git rebase main
# featureのコミットがmainの上に再適用される

    A---B---C---D  （main）
                 \
                  E'---F'---G'  （feature、再適用済み）

# 最近5つのコミットを対話的に編集
git rebase -i HEAD~5

pick a1b2c3d feat: add user model
pick d4e5f6g fix: typo in user model
pick h7i8j9k feat: add user controller
pick l0m1n2o WIP: debugging
pick p3q4r5s feat: add user routes

pick a1b2c3d feat: add user model
fixup d4e5f6g fix: typo in user model
pick h7i8j9k feat: add user controller
drop l0m1n2o WIP: debugging
pick p3q4r5s feat: add user routes

# 元のコミット
git commit -m "feat: add user model"

# 後で修正が必要な時
git commit --fixup HEAD
# または特定のコミットを指定
git commit --fixup a1b2c3d

# 自動的に整理
git rebase -i --autosquash main

# 安全なリベース（個人のfeatureブランチ）
git checkout feature/my-task
git rebase main

# 危険なリベース（絶対にやらないで！）
git checkout main
git rebase feature/something  # 禁止！

# 直前のコミットメッセージを修正（まだプッシュしていない場合）
git commit --amend -m "feat: add user authentication"

# エディタでメッセージを修正
git commit --amend

# 状況：mainにコミットすべきものをfeatureブランチにした
# 方法1：cherry-pick
git checkout main
git cherry-pick abc1234
git checkout feature/wrong-branch
git reset --hard HEAD~1

# 方法2：stash活用
git reset --soft HEAD~1
git stash
git checkout correct-branch
git stash pop
git commit -m "correct commit message"

# 安全な方法：revert（新しいコミットで戻す、履歴保存）
git revert abc1234
git push

# 危険な方法：reset + force push（履歴変更）
git reset --hard HEAD~1
git push --force-with-lease
# force-with-leaseは他の人のコミットを上書きしないよう保護

# コンフリクト発生時
git merge feature/login
# CONFLICT (content): Merge conflict in src/auth.js

# コンフリクトファイルの確認
git status

# コンフリクトマーカーの構造
# <<<<<<< HEAD
# 現在のブランチのコード
# =======
# マージしようとしているブランチのコード
# >>>>>>> feature/login

# 手動解決後
git add src/auth.js
git commit -m "resolve merge conflict in auth module"

# 1. mainを頻繁に取り込んで同期
git fetch origin
git rebase origin/main

# 2. 小さな単位で頻繁にコミットしてマージ
# 3. チーム内のファイル所有権を明確にする（CODEOWNERS）
# 4. マージツールの設定
git config --global merge.tool vimdiff
git mergetool

# bisect開始
git bisect start

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

# バグがなかったコミットをgoodとしてマーク
git bisect good v1.0.0

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

# 繰り返すとバグを導入した正確なコミットが見つかる
# 結果: abc1234 is the first bad commit

# bisect終了
git bisect reset

# テストスクリプトが失敗するとbad、成功するとgood
git bisect start HEAD v1.0.0
git bisect run npm test
# 自動的にバグコミットを見つけてくれます！

# 方法1：git-filter-repo（推奨）
pip install git-filter-repo
git filter-repo --path large-file.zip --invert-paths

# 方法2：BFG Repo-Cleaner
java -jar bfg.jar --delete-files large-file.zip
git reflog expire --expire=now --all
git gc --prune=now --aggressive

# 予防：.gitignore設定
echo "*.zip" >> .gitignore
echo "*.tar.gz" >> .gitignore
echo "node_modules/" >> .gitignore

# ファイルの変更をhunk単位で選択的にステージング
git add -p src/utils.js

# 各hunkに対して：
# y - このhunkをステージング
# n - このhunkをスキップ
# s - より小さなhunkに分割
# e - 手動で編集
# q - 終了

# 方法1：stash
git stash push -m "WIP: feature work"
git checkout main
git checkout -b hotfix/critical-bug
# ホットフィックス作業...
git checkout feature/my-work
git stash pop

# 方法2：worktree（より良い方法！）
git worktree add ../hotfix-workspace main
cd ../hotfix-workspace
git checkout -b hotfix/critical-bug
# ホットフィックス作業...
cd ../main-workspace
git worktree remove ../hotfix-workspace

# 方法1：interactive rebase
git rebase -i HEAD~4
# 最初をpick、残りをsquashに変更

# 方法2：soft reset
git reset --soft HEAD~4
git commit -m "feat: complete user authentication"

# 方法3：merge --squash
git checkout main
git merge --squash feature/user-auth
git commit -m "feat: add user authentication system"

# サブモジュールの追加
git submodule add https://github.com/org/shared-lib.git libs/shared

# クローン時にサブモジュールを含める
git clone --recurse-submodules https://github.com/org/project.git

# サブモジュールの更新
git submodule update --remote --merge

# すべてのサブモジュールでコマンド実行
git submodule foreach 'git checkout main && git pull'

# reflogで削除されたブランチの最後のコミットを探す
git reflog
# abc1234 HEAD@{5}: checkout: moving from deleted-branch to main

# ブランチの復元
git checkout -b recovered-branch abc1234

# mainブランチの特定ファイルを現在のブランチに取得
git checkout main -- src/config.js

# 特定コミットのファイルを取得
git checkout abc1234 -- src/config.js

# 最後のコミットの日付を現在時刻に変更
GIT_COMMITTER_DATE="$(date)" git commit --amend --date="$(date)"

# 特定の日付に変更（リベース中）
GIT_COMMITTER_DATE="2026-03-22T10:00:00" git commit --amend --date="2026-03-22T10:00:00"

# ファイルの各行を誰が最後に修正したか確認
git blame src/auth.js

# 特定の行範囲のみ確認
git blame -L 10,20 src/auth.js

# 空白変更を無視
git blame -w src/auth.js

# コード移動も追跡
git blame -M src/auth.js
git blame -C src/auth.js

# 特定ファイルの変更履歴
git log --follow -p -- src/auth.js

# 特定の文字列が追加/削除されたコミットを探す（pickaxe）
git log -S "API_KEY" --oneline

# 特定の著者のコミットのみ
git log --author="John" --oneline --since="2026-01-01"

# 統計情報を含む
git log --stat --oneline -10

# コミット間のdiff
git log -p --oneline -3

# 複数のリモートリポジトリを追加
git remote add upstream https://github.com/original/repo.git
git remote add deploy git@deploy-server:app.git

# upstreamの同期（フォークプロジェクト）
git fetch upstream
git rebase upstream/main

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

# アノテーティッドタグの作成
git tag -a v2.0.0 -m "Release 2.0.0: new payment system"

# 特定のコミットにタグ
git tag -a v1.5.0 abc1234 -m "Hotfix release"

# タグのプッシュ
git push origin v2.0.0
git push origin --tags

# タグの削除
git tag -d v2.0.0-beta
git push origin --delete v2.0.0-beta

# .husky/pre-commit
#!/bin/sh
npx lint-staged

# .husky/commit-msg
#!/bin/sh
npx commitlint --edit "$1"

# .husky/pre-push
#!/bin/sh
npm test

# パッチの作成
git diff > my-changes.patch
git format-patch -3  # 最近3つのコミットをパッチファイルに

# パッチの適用
git apply my-changes.patch
git am *.patch  # format-patchで作成されたパッチを適用

# reflogを確認（HEADの移動履歴）
git reflog

# 誤ってreset --hardした場合の復元
git reflog
# abc1234 HEAD@{2}: commit: important work
git reset --hard abc1234

# 誤って削除したstashの復元
git fsck --unreachable | grep commit
git stash apply abc1234

type(scope): description

[optional body]

[optional footer(s)]

feat(api)!: change authentication endpoint

BREAKING CHANGE: /auth/login is now /api/v2/auth/login

# パッケージのインストール
npm install -D @commitlint/cli @commitlint/config-conventional husky

# commitlintの設定
echo "module.exports = { extends: ['@commitlint/config-conventional'] };" > commitlint.config.js

# Huskyの初期化
npx husky init
echo 'npx commitlint --edit "$1"' > .husky/commit-msg

# conventional-changelogのインストール
npm install -D conventional-changelog-cli

# CHANGELOG.mdの生成
npx conventional-changelog -p angular -i CHANGELOG.md -s

{
  "scripts": {
    "changelog": "conventional-changelog -p angular -i CHANGELOG.md -s",
    "release": "standard-version"
  }
}

npm install -D semantic-release

{
  "release": {
    "branches": ["main"],
    "plugins": [
      "@semantic-release/commit-analyzer",
      "@semantic-release/release-notes-generator",
      "@semantic-release/changelog",
      "@semantic-release/npm",
      "@semantic-release/github",
      "@semantic-release/git"
    ]
  }
}

name: CI Pipeline

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest
    strategy:
      matrix:
        node-version: [18, 20, 22]

    steps:
      - uses: actions/checkout@v4

      - name: Use Node.js
        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node-version }}
          cache: 'npm'

      - run: npm ci
      - run: npm run lint
      - run: npm test
      - run: npm run build

name: PR Checks

on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  lint-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: 20
          cache: 'npm'

      - run: npm ci

      - name: Lint
        run: npm run lint

      - name: Type Check
        run: npx tsc --noEmit

      - name: Unit Tests
        run: npm test -- --coverage

      - name: Build
        run: npm run build

      - name: Upload coverage
        uses: codecov/codecov-action@v4
        with:
          file: ./coverage/lcov.info

name: Auto Label

on:
  pull_request:
    types: [opened, edited]

jobs:
  label:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/labeler@v5
        with:
          repo-token: ${{ secrets.GITHUB_TOKEN }}

# .github/labeler.yml
frontend:
  - changed-files:
      - any-glob-to-any-file: 'src/components/**'

backend:
  - changed-files:
      - any-glob-to-any-file: 'src/api/**'

documentation:
  - changed-files:
      - any-glob-to-any-file: 'docs/**'

tests:
  - changed-files:
      - any-glob-to-any-file: '**/*.test.*'

# .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: 'npm'
    directory: '/'
    schedule:
      interval: 'weekly'
      day: 'monday'
    open-pull-requests-limit: 10
    labels:
      - 'dependencies'
    groups:
      dev-dependencies:
        dependency-type: 'development'
      production-dependencies:
        dependency-type: 'production'

  - package-ecosystem: 'github-actions'
    directory: '/'
    schedule:
      interval: 'weekly'

name: Deploy

on:
  push:
    tags:
      - 'v*'

jobs:
  deploy:
    runs-on: ubuntu-latest
    environment: production
    steps:
      - uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: 20

      - run: npm ci
      - run: npm run build

      - name: Deploy to Production
        run: |
          echo "Deploying version $GITHUB_REF_NAME"
          # 実際のデプロイコマンド

# Nxの初期化
npx create-nx-workspace@latest my-workspace

# Turborepoの初期化
npx create-turbo@latest

# プロジェクト構造の例
my-monorepo/
  apps/
    web/          # Next.js Webアプリ
    mobile/       # React Nativeアプリ
    api/          # Express APIサーバー
  packages/
    ui/           # 共有UIコンポーネント
    utils/        # 共有ユーティリティ
    config/       # 共有設定
  turbo.json
  package.json

# .github/CODEOWNERS

# プロジェクト全体のデフォルトレビューア
* @team-lead

# フロントエンド
/apps/web/        @frontend-team
/packages/ui/     @frontend-team

# バックエンド
/apps/api/        @backend-team
/packages/utils/  @backend-team

# DevOps
/.github/         @devops-team
/docker/          @devops-team
*.yml             @devops-team

{
  "pipeline": {
    "build": {
      "dependsOn": ["^build"],
      "outputs": ["dist/**"]
    },
    "test": {
      "dependsOn": ["build"]
    },
    "lint": {}
  }
}

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

# 特定のアプリのみビルド
npx turbo run build --filter=web

# 依存関係を含めてビルド
npx turbo run build --filter=web...

# 最新1つのコミットのみクローン（CI/CDで有用）
git clone --depth 1 https://github.com/org/repo.git

# 後で完全な履歴が必要になったら
git fetch --unshallow

# Blobなしでクローン（必要な時にダウンロード）
git clone --filter=blob:none https://github.com/org/repo.git

# Treeも除外（最速のクローン）
git clone --filter=tree:0 https://github.com/org/repo.git

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

# 特定のディレクトリのみチェックアウト
git sparse-checkout set apps/web packages/ui

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

# 設定を確認
git sparse-checkout list

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

# 大容量ファイルの追跡
git lfs track "*.psd"
git lfs track "*.zip"
git lfs track "assets/videos/*"

# .gitattributesを確認
cat .gitattributes
# *.psd filter=lfs diff=lfs merge=lfs -text

# LFSの状態を確認
git lfs ls-files
git lfs status

# 自動メンテナンスを有効化
git maintenance start

# 手動でガベージコレクション
git gc --aggressive

# オブジェクトの圧縮状態を確認
git count-objects -vH

# 不要な参照の整理
git remote prune origin
git reflog expire --expire=30.days

# Scalarに登録（Git 2.38+に含まれる）
scalar register

# または新規クローン
scalar clone https://github.com/org/massive-repo.git

# Scalarが自動的に設定するもの：
# - Partial clone
# - Sparse checkout
# - Background maintenance
# - Filesystem monitor
# - Commit graph

# Claude Codeで自動コミットメッセージ生成
claude commit

# GitHub Copilot CLI
gh copilot suggest "write a commit message for these changes"

# aicommitsツール
npm install -g aicommits
aicommits

# GitHub Copilot自動レビューの有効化（リポジトリ設定で）
# Settings > Code review > Copilot code review > Enable

# ステージされた変更のレビューを依頼
claude "review my staged changes"

# コミットメッセージの作成
claude "write a conventional commit message for my changes"

# PR説明文の生成
claude "write a PR description for the current branch"

# マージコンフリクトの解決
claude "help me resolve the merge conflicts in src/auth.js"

name: Auto PR Description

on:
  pull_request:
    types: [opened]

jobs:
  describe:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Generate PR description
        uses: anthropics/claude-code-action@v1
        with:
          prompt: |
            Analyze the diff of this PR and generate a clear description
            including what changed, why, and any risks.