git worktree

実行前の状態

main ブランチで README.md を書き換えている途中に、hotfix ブランチで急ぎの修正を頼まれた場面です。書きかけの変更は、コミットも退避もしたくありません。別のフォルダに hotfix を開けば、いまの作業をそのまま残して修正に行けます。

この状態を手元で作るなら、次の順に打ちます。git branch hotfix は、hotfix ブランチを作る操作です。

git init -q -b main hello
cd hello
echo "# hello" > README.md
git add README.md
git commit -q -m "README を作る"
git branch hotfix
echo "書きかけ" >> README.md

最小の例と結果

開きたいブランチ (hotfix) を、フォルダの置き場所と一緒に書きます。リポジトリの外に並べると、取り違えにくくなります。

git worktree add ../hello-hotfix hotfix

Preparing worktree (checking out 'hotfix')
HEAD is now at a1b2c3d README を作る

../hello-hotfix は、リポジトリの隣に作るフォルダです。このフォルダでは hotfix ブランチが開かれています。もとの hello フォルダの書きかけは、そのままです。

成功の確認

別のフォルダで開いているブランチには、git branch で + が付きます。

git branch

+ hotfix
* main

git -C ../hello-hotfix branch --show-current

hotfix

git status -s

 M README.md

最後の行は、もとのフォルダの書きかけが残っているという意味です。* は、いま居るフォルダのブランチです。

構文と主要オプション

失敗時の戻し方

同じブランチは 2 か所で開けない

main を開いているあいだに、別のフォルダで main を開こうとすると、断られます。別のフォルダで開きたいときは、git worktree add -b で新しいブランチを作ります。

フォルダを閉じるとき

作業が済んだら、git worktree remove ../hello-hotfix を打ちます。このコマンドは、フォルダを消します。コミットしていない変更が残っているフォルダは、断られて消えません。変更が要らないと決めたときだけ --force を付けます。

フォルダを Finder やエクスプローラーで消してしまったとき

登録の跡が残ります。git worktree prune で片付けます。ブランチは消えません。コミット済みの変更も、ブランチに残っています。

よくある疑問

関連

• ブランチとは何か受講生向けのレッスン
• ブランチを作って移動する (switch) 受講生向けのレッスン
• git stash 変更を一時退避して、同じフォルダで切り替える
• git rebase 別のフォルダで開いたブランチを、最新に合わせる