Gitのswitch –orphanで、履歴のないブランチを作る方法

​​Git​コマンドライン

git switch --orphan <ブランチ名> を実行すると、今までのコミットとつながらない、空のブランチに切り替わります。公開用のページやドキュメントだけを置くブランチのように、本体のソースコードとは別の中身を同じリポジトリで管理したいときに使います。操作の前と後で git status や git log の出力がどう変わるかを、検証環境で順に確かめました。

補足

検証環境は Ubuntu 24.04、Git 2.43.0 です。作者の名前とメールアドレスには例示用の値(Neko <neko@example.com>)を設定しました。リモートは、同じ環境の中に作った空のリポジトリで代用しています。git switch は Git 2.23.0 で入ったコマンドで、それより古い Git にはありません。Windows・macOS、GitHub などのホスティングサービスへのプッシュは試していません。

操作の前のリポジトリ

main ブランチに2つのコミットがあるリポジトリで試しました。memo.txt は、まだ Git で管理していないファイルです。

console
$ git branch
* main

$ git log --oneline
ea9e292 送料を400円に変更
ae84adb 最初のコミット

$ ls
README.md
memo.txt
price.txt

$ git status --short
?? memo.txt

書き換えたファイルがあると、切り替えずに止まる

site を作る前の main で、Git で管理している price.txt を書き換えたまま git switch --orphan site を実行すると、切り替えずに止まりました。エラーでは、書き換えた内容が上書きされるので、先にコミットするか stash するよう求められます。

console
$ echo "送料: 0円" > price.txt && git status --short
 M price.txt
?? memo.txt

$ git switch --orphan site
error: Your local changes to the following files would be overwritten by checkout:
	price.txt
Please commit your changes or stash them before you switch branches.
Aborting

$ git branch --show-current
main

git restore price.txt で書き換えを元に戻してから、次の操作に進みました。

git switch –orphan で切り替える

site という名前で、履歴のないブランチを作りました。切り替えたあとは、README.md と price.txt が作業フォルダから消え、memo.txt だけが残りました。

console
$ git switch --orphan site
Switched to a new branch 'site'

$ ls -A
.git
memo.txt

git switch の公式リファレンスの --orphan の項には、Git で管理しているファイルはすべて取り除かれると書かれています。Git で管理していない memo.txt は対象にならないので、そのまま残ります。取り除かれた README.md と price.txt は、main のコミットに入っているので、main に戻れば元どおりになります(次の節で確かめます)。

git status には「No commits yet」(まだコミットがない)と出ます。git log はエラーになりました。

console
$ git status
On branch site

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	memo.txt

nothing added to commit but untracked files present (use "git add" to track)

$ git log
fatal: your current branch 'site' does not have any commits yet

git branch の一覧には、まだ site が出てきません。今いるブランチの名前を表示する git branch --show-current では、site と表示されました。

console
$ git branch
  main

$ git branch --show-current
site

git switch の公式リファレンスでは、このような、名前はあってもまだコミットが1つもないブランチを「unborn branch」と呼んでいます。

最初のコミットの前に元のブランチに戻ると、ブランチは残らない

コミットを作らずに main に戻ると、site ブランチはなくなりました。git switch site で戻ろうとしても、ブランチが見つからないというエラーになります。

console
$ git switch main
Switched to branch 'main'

$ git branch
* main

$ ls
README.md
memo.txt
price.txt

$ git switch site
fatal: invalid reference: site

main に戻ると、README.md と price.txt も戻りました。作り直すときは、もう一度 git switch --orphan site を実行します。

最初のコミットを作ると、親のないコミットになる

もう一度 site に切り替え、公開用のページ index.html を作ってコミットしました。コミットの表示に (root-commit) と出ています。

console
$ git switch --orphan site
Switched to a new branch 'site'

$ printf "<h1>猫の手ストア</h1>\n" > index.html

$ git add index.html && git commit -m "公開用のページを追加"
[site (root-commit) f2a4551] 公開用のページを追加
 1 file changed, 1 insertion(+)
 create mode 100644 index.html

ここで初めて、git branch の一覧に site が出ます。git log で見える履歴は、今作ったコミット1つだけです。

console
$ git branch
  main
* site

$ git log --oneline
f2a4551 公開用のページを追加

すべてのブランチのコミットを、親のコミットと一緒に表示しました(%p は親のコミットのハッシュです)。f2a4551 には、main の最初のコミット ae84adb と同じく、親がありません。親のないコミットだけを表示する git rev-list --max-parents=0 でも、この2つが出ました。

console
$ git log --all --format="%h 親:%p %s"
f2a4551 親: 公開用のページを追加
ea9e292 親:ae84adb 送料を400円に変更
ae84adb 親: 最初のコミット

$ git rev-list --max-parents=0 --abbrev-commit --all
f2a4551
ae84adb
main ブランチの ae84adb と ea9e292 は親子でつながっていて、site ブランチの f2a4551 には親のコミットがなく、2つの履歴のあいだにつながりがないことを示す図
main の履歴と、git switch –orphan で作った site の履歴

2つのブランチの共通の祖先を探す git merge-base は、何も表示せずに終了コード1で終わりました。main と site には、共通の祖先のコミットがありません。

console
$ git merge-base main site; echo "終了コード: $?"
終了コード: 1

コミットしたあとも、Git で管理していない memo.txt は作業フォルダに残っています。

console
$ git status --short
?? memo.txt
注意

git switch --orphan のあとに git add . でまとめて追加すると、memo.txt のような Git で管理していないファイルまで、新しいブランチの最初のコミットに入ります。別の名前の空のブランチで試したところ、git add . のあとの git status --short に A memo.txt と出ました。追加するファイルは名前を指定し、コミットの前に git status --short で中身を確かめてください。

同じ名前のブランチがあるとき

site にいる状態で、既にあるブランチの名前 main を渡すと、エラーになりました。

console
$ git switch --orphan main
fatal: a branch named 'main' already exists

main に戻ると、元のファイルと履歴がそろっている

site でコミットしたあとに main に戻ると、README.md と price.txt が戻り、index.html は見えなくなりました。main の履歴も、操作の前と同じです。

console
$ git switch main
Switched to branch 'main'

$ ls
README.md
memo.txt
price.txt

$ git log --oneline
ea9e292 送料を400円に変更
ae84adb 最初のコミット

共通の祖先がない site を main に git merge しようとすると、「refusing to merge unrelated histories」(関係のない履歴どうしはマージしない)というエラーで止まりました。このエラーへの対処は、別の記事「Gitのunrelated historiesエラーを直す方法」で扱っています。

console
$ git merge site
fatal: refusing to merge unrelated histories

git checkout –orphan は、ファイルを残したまま切り替わる

git switch が入る前からある git checkout --orphan でも、履歴のないブランチを作れます。ただし、切り替えたあとの状態が違います。main から git checkout --orphan docs を実行すると、README.md と price.txt は消えずに、次のコミットに含めるファイルとしてステージされた状態(A)になりました。

console
$ git checkout --orphan docs
Switched to a new branch 'docs'

$ git status --short
A  README.md
A  price.txt
?? memo.txt

$ ls
README.md
memo.txt
price.txt

git checkout の公式リファレンスの --orphan の項によると、これは今のコミットの中身を、履歴を見せずに公開したいときに向いた動きです。同じ項には、このまま git commit -a を実行すれば、同じファイルを持った最初のコミットを作れると書かれています。まったく別の中身にしたいときは、作業フォルダの一番上で git rm -rf . を実行して空にするよう案内されています。実行すると、git switch --orphan の直後と同じように、Git で管理していない memo.txt だけが残りました。

console
$ git rm -rf -q . && git status --short && ls
?? memo.txt
memo.txt

ここではコミットせずに main に戻りました。docs は一度もコミットしていないので、git branch の一覧には残りません。

console
$ git switch main
Switched to branch 'main'

$ git branch
* main
  site

空のブランチから始めたいなら、git switch --orphan を使えば git rm -rf . の手間がいりません。

リモートに送る

作った site ブランチは、ふつうのブランチと同じように git push でリモートに送れます。同じ環境に作った空のリポジトリを origin にして、main と site をまとめて送りました(出力のうち、送り先のフォルダのパスが出る「To」の行は省いています)。

console
$ git push -u origin main site
 * [new branch]      main -> main
 * [new branch]      site -> site
branch 'main' set up to track 'origin/main'.
branch 'site' set up to track 'origin/site'.

$ git branch -vv
* main ea9e292 [origin/main] 送料を400円に変更
  site f2a4551 [origin/site] 公開用のページを追加

​Posted by 86