| name | git-worktree |
| description | Git worktree を使った複数ブランチの同時作業管理。 使用タイミング: (1) 複数機能を並行開発したい時 (2) PRレビュー中に別作業したい時 (3) 本番ホットフィックスと開発を同時進行したい時 (4) worktreeの使い方を知りたい時。 トリガー例: 「worktreeで」「別ブランチを同時に」「並行開発したい」 「PRレビューしながら開発」「ホットフィックス用のworktree」
|
git-worktree - Git Worktree 操作
複数ブランチを同時に作業するための Git worktree 管理。
概要
Git worktree を使うと、1つのリポジトリから複数の作業ディレクトリを作成できる。
メリット:
- ブランチ切り替えなしで複数機能を並行開発
- PRレビュー中に別作業が可能
- 本番ホットフィックスと開発を同時進行
基本コマンド
Worktree 作成
git worktree add ../project-feature-x feature-x
git worktree add ../project-hotfix hotfix/urgent-fix
git worktree add ../project-review origin/feature-y
Worktree 一覧
git worktree list
出力例:
/path/to/project abc1234 [main]
/path/to/project-feature def5678 [feature-x]
/path/to/project-hotfix ghi9012 [hotfix/urgent-fix]
Worktree 削除
rm -rf ../project-feature-x
git worktree prune
または一括:
git worktree remove ../project-feature-x
ワークフロー例
1. 機能開発中にホットフィックス
git worktree add ../project-hotfix -b hotfix/login-fix main
cd ../project-hotfix
git commit -m "fix: resolve login issue"
git push origin hotfix/login-fix
cd ../project
2. PRレビュー
git fetch origin
git worktree add ../project-review origin/feature-y
cd ../project-review
npm install
npm run dev
cd ../project
git worktree remove ../project-review
ベストプラクティス
ディレクトリ命名
project/ # メイン (main)
project-feature-x/ # 機能開発
project-hotfix/ # ホットフィックス
project-review/ # PRレビュー
定期クリーンアップ
git worktree list
git worktree remove ../project-merged-feature
git worktree prune
注意点
- 同じブランチを複数 worktree で開けない
- node_modules は各 worktree で別途インストール必要
- .env ファイルもコピーが必要
トラブルシューティング
"already checked out" エラー
git worktree list
孤立した worktree
git worktree prune
ブランチ削除時
git worktree remove ../project-feature
git branch -d feature