Gitのswitch –orphanで、履歴のないブランチを作る方法
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 で管理していないファイルです。
$ 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 するよう求められます。
$ 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 だけが残りました。
$ 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 はエラーになりました。
$ 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 と表示されました。
$ git branch
main
$ git branch --show-current
site
git switch の公式リファレンスでは、このような、名前はあってもまだコミットが1つもないブランチを「unborn branch」と呼んでいます。
最初のコミットの前に元のブランチに戻ると、ブランチは残らない
コミットを作らずに main に戻ると、site ブランチはなくなりました。git switch site で戻ろうとしても、ブランチが見つからないというエラーになります。
$ 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) と出ています。
$ 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つだけです。
$ git branch
main
* site
$ git log --oneline
f2a4551 公開用のページを追加
すべてのブランチのコミットを、親のコミットと一緒に表示しました(%p は親のコミットのハッシュです)。f2a4551 には、main の最初のコミット ae84adb と同じく、親がありません。親のないコミットだけを表示する git rev-list --max-parents=0 でも、この2つが出ました。
$ git log --all --format="%h 親:%p %s"
f2a4551 親: 公開用のページを追加
ea9e292 親:ae84adb 送料を400円に変更
ae84adb 親: 最初のコミット
$ git rev-list --max-parents=0 --abbrev-commit --all
f2a4551
ae84adb

2つのブランチの共通の祖先を探す git merge-base は、何も表示せずに終了コード1で終わりました。main と site には、共通の祖先のコミットがありません。
$ git merge-base main site; echo "終了コード: $?"
終了コード: 1
コミットしたあとも、Git で管理していない memo.txt は作業フォルダに残っています。
$ 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 を渡すと、エラーになりました。
$ git switch --orphan main
fatal: a branch named 'main' already exists
main に戻ると、元のファイルと履歴がそろっている
site でコミットしたあとに main に戻ると、README.md と price.txt が戻り、index.html は見えなくなりました。main の履歴も、操作の前と同じです。
$ 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エラーを直す方法」で扱っています。
$ 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)になりました。
$ 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 だけが残りました。
$ git rm -rf -q . && git status --short && ls
?? memo.txt
memo.txt
ここではコミットせずに main に戻りました。docs は一度もコミットしていないので、git branch の一覧には残りません。
$ git switch main
Switched to branch 'main'
$ git branch
* main
site
空のブランチから始めたいなら、git switch --orphan を使えば git rm -rf . の手間がいりません。
リモートに送る
作った site ブランチは、ふつうのブランチと同じように git push でリモートに送れます。同じ環境に作った空のリポジトリを origin にして、main と site をまとめて送りました(出力のうち、送り先のフォルダのパスが出る「To」の行は省いています)。
$ 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] 公開用のページを追加




