Git Worktree実用ガイド - 並行開発での実際の活用法

はじめに

複数の機能開発を並行して進めているときに、ブランチを切り替えるたびに以下のような問題に悩まされていませんか？

• ビルドキャッシュがクリアされて、再ビルドに時間がかかる
• 作業中の変更を一時的に stash する必要がある
• node_modules などの依存関係を再インストールする必要がある
• 複数のブランチ間でのコードレビューが面倒

Git worktreeは、これらの問題を部分的に解決できる便利な機能ですが、万能ではありません。

Git Worktreeとは？

Git worktree は、1つのリポジトリから複数の作業ディレクトリを作成できる機能です。各 worktree は独立したファイルシステムを持ち、異なるブランチで同時に作業できます。

従来のcheckoutの問題点

なぜgit Worktreeが革命的なのか

1. ゼロ・コンテキストスイッチ

2. 並行開発の真の実現

3. 実際の生産性向上データ

実践的な使い方

基本的なworktreeの操作

# 新しいworktreeを作成（既存のブランチ）
$ git worktree add ../myproject-feature feature-branch

# 新しいブランチと同時に作成
$ git worktree add -b new-feature ../myproject-new-feature

# 特定のコミットから作成
$ git worktree add ../myproject-fix abc123

# detached HEADで作成
$ git worktree add --detach ../myproject-experiment

# worktreeの一覧を表示
$ git worktree list
/Users/user/myproject          abc123 [main]
/Users/user/myproject-feature  def456 [feature-branch]
/Users/user/myproject-fix      ghi789 [hotfix]

# 詳細情報付きで表示
$ git worktree list --porcelain
worktree /Users/user/myproject
HEAD abc1234567890abcdef
branch refs/heads/main

worktree /Users/user/myproject-feature
HEAD def4567890abcdef123
branch refs/heads/feature-branch

# worktreeを削除
$ git worktree remove ../myproject-feature

# 強制削除（変更がある場合）
$ git worktree remove --force ../myproject-feature

# 削除済みworktreeのクリーンアップ
$ git worktree prune

# dry-runで確認
$ git worktree prune --dry-run

# worktreeを移動
$ git worktree move ../myproject-feature ../projects/feature

# 相対パスでも絶対パスでも可能
$ git worktree move myproject-old /home/user/projects/myproject-new

実践的なワークフロー

1. 機能開発とバグ修正の並行作業

# メインプロジェクトで機能開発中
$ pwd
/home/user/myproject

# 緊急のバグ修正が必要になった
$ git worktree add -b hotfix-critical ../myproject-hotfix origin/main

# 別のターミナルでバグ修正
$ cd ../myproject-hotfix
$ code .  # VSCodeで開く
# バグ修正を実施...

# 元の機能開発を継続（別のターミナル）
$ cd ../myproject
# 開発を継続...

2. コードレビューの効率化

# レビュー対象のPRをworktreeで確認
$ git worktree add ../review-pr-123 origin/feature-xyz

# 実際にコードを実行して動作確認
$ cd ../review-pr-123
$ npm install
$ npm run dev

# レビューコメントに基づく修正の提案
$ git checkout -b feature-xyz-suggestions
# 修正を実施してpush

3. 実験的な変更の隔離

# 実験用のworktreeを作成
$ git worktree add -b experiment-new-arch ../myproject-experiment

# 大規模なリファクタリングを実施
$ cd ../myproject-experiment
# アーキテクチャの変更...

# メインの開発には影響なし
$ cd ../myproject
# 通常の開発を継続

Checkoutとの使い分けガイドライン

Git Worktreeを使うべき場面

従来のCheckoutで十分な場面

ベストプラクティス

1. 命名規則の統一

# プロジェクト名-ブランチ名 の形式を推奨
myproject-main
myproject-feature-auth
myproject-hotfix-security
myproject-experiment-new-ui

2. ディレクトリ構造の整理

~/projects/
├── myproject/          # メインのworktree
├── myproject-feature/  # 機能開発用
├── myproject-hotfix/   # バグ修正用
└── myproject-review/   # コードレビュー用

3. .gitignoreの活用

# プロジェクトルートの.gitignoreに追加
/myproject-*/
/worktrees/

4. エイリアスの設定

# ~/.gitconfigに追加
[alias]
    wt = worktree
    wta = worktree add
    wtl = worktree list
    wtr = worktree remove
    
    # 便利なカスタムエイリアス
    new-feature = "!f() { git worktree add -b $1 ../$(basename $(pwd))-$1; }; f"
    review = "!f() { git worktree add ../$(basename $(pwd))-review-$1 $1; }; f"

トラブルシューティング

よくある問題と解決方法

git worktree repair

パフォーマンスの最適化

# 不要なworktreeをクリーンアップ
git worktree prune

# worktreeのガベージコレクション
git gc --aggressive

# 大きなリポジトリでの最適化
git config core.preloadindex true
git config core.fscache true

実際の導入事例

Git worktree は特定のケースでは確かに便利ですが、チーム全員が使いこなすには学習コストとディスク容量の問題がありました。プロジェクトごとに判断しています。

大きなプロジェクト（Next.js）では worktree が重宝ですが、小さなサイトではオーバーヘッドの方が大きいです。ケースバイケースで使い分けています。

高度な活用テクニック

1. CI/CDとの連携

# GitHub Actions の例
name: Parallel Testing
on: [push, pull_request]

jobs:
  test:
    strategy:
      matrix:
        branch: [main, develop, staging]
    steps:
      - uses: actions/checkout@v3
      - name: Setup worktrees
        run: |
          git worktree add ../test-${{ matrix.branch }} origin/${{ matrix.branch }}
          cd ../test-${{ matrix.branch }}
          npm install
          npm test

2. スクリプトによる自動化

#!/bin/bash
# worktree-manager.sh

function create_review_worktree() {
    local pr_number=$1
    local branch_name="pr-${pr_number}"
    local worktree_path="../$(basename $(pwd))-review-${pr_number}"
    
    echo "Creating worktree for PR #${pr_number}..."
    git fetch origin pull/${pr_number}/head:${branch_name}
    git worktree add ${worktree_path} ${branch_name}
    
    echo "Worktree created at: ${worktree_path}"
    cd ${worktree_path}
    code .  # VSCodeで開く
}

# 使用例: ./worktree-manager.sh create_review_worktree 123

3. Dockerとの組み合わせ

# 複数のworktreeを含むDockerイメージ
FROM node:18-alpine

WORKDIR /app
COPY . .

# 複数のworktreeをセットアップ
RUN git worktree add /app-staging origin/staging && \
    git worktree add /app-develop origin/develop

# 各worktreeでビルド
RUN cd /app && npm install && npm run build && \
    cd /app-staging && npm install && npm run build && \
    cd /app-develop && npm install && npm run build

まとめ

Git worktree は、特定の状況で非常に有用なツールです。ただし、万能ではないため、以下のような環境での導入を検討しましょう：

• 複数の機能を並行開発するチーム
• ビルドに時間がかかる大規模プロジェクト
• 頻繁なコンテキストスイッチが必要な環境
• 実験的な変更を安全に試したい場合

# まずは緑急時のみ使用
git worktree add -b hotfix-urgent ../project-hotfix

関連記事

🔧 Git高度な活用

• Git rebase 完全マスターガイド - ブランチ履歴を美しく保つ技術
• Lazygit vs GitUI 徹底比較 - ターミナルベースの Git UI

💻 開発環境・ツール

• ターミナル生産性向上 Tips - Git操作を含む効率化
• モダン CLI ツール 2024 - 開発効率を上げるツール群

この記事が役に立ったら、ぜひチームメンバーにもシェアしてください。git worktree を活用して、より効率的な開発ライフを送りましょう！