git「src refspec main does not match any」の原因と直し方
src refspec main does not match any は、コミットを 1 つ作るか、手元のブランチ名に合わせて push すれば直る。
push に書いた名前のブランチやタグが手元に無いと出る。
公開: 更新:
git push -u origin main error: src refspec main does not match any error: failed to push some refs to '../remote.git'
git push -u origin main To ../remote.git * [new branch] main -> main branch 'main' set up to track 'origin/main'.
2026-11-17 に alpine/git(Git 2.54.1) で実際に打って取った出力。検証環境の詳細
要約
新しく作ったリポジトリで git push -u origin main を打つと、何も送られずに次の 2 行で終わる。
error: src refspec main does not match any
error: failed to push some refs to '/tmp/remote.git'src refspec main does not match any は、push に書いた main という名前が手元のどのブランチにもタグにも当たらなかったという意味である。
コミットを 1 つ作るか、手元のブランチ名に合わせて push すれば直る。
Git 2.54.0 で、次の 3 つの場合がどれも終了コード 1 のこのエラーになった。
実行例
alpine/git のコンテナで、コミットの無いリポジトリから git push -u origin main を打つと、終了コード 1 で src refspec main does not match any が出た。
コミット後もブランチが master のうちは同じエラーになり、git branch -M main で改名すると push が通った。
$ git status
On branch master
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
README.md
nothing added to commit but untracked files present (use "git add" to track)$ git push -u origin main
error: src refspec main does not match any
error: failed to push some refs to '../remote.git'
$ echo $?
1$ git add .$ git commit -m "first commit"
[master (root-commit) cba5012] first commit
1 file changed, 1 insertion(+)
create mode 100644 README.md$ git push -u origin main
error: src refspec main does not match any
error: failed to push some refs to '../remote.git'
$ echo $?
1$ git branch --show-current
master$ git branch -M main$ git push -u origin main
To ../remote.git
* [new branch] main -> main
branch 'main' set up to track 'origin/main'.
$ echo $?
0$ git push origin HEAD:release
To ../remote.git
* [new branch] HEAD -> release
$ echo $?
0— 2026-11-17 時点の出力
検証環境Git 2.54.1 / 2026-11-17 検証
- 検証日
- 実行環境
alpine/gitAlpine Linux v3.24- バージョン
- Git 2.54.1
この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。
解決策
1. 最初のコミットを作ってから push する
git add .
git commit -m "first commit"
git push -u origin maingit status が No commits yet を返さなくなれば、ブランチの実体ができている。git commit が Author identity unknown や nothing to commit で終わっていると、コミットはまだ無い。
2. 手元のブランチ名に合わせる
いま居るブランチの名前は git branch --show-current で分かる。master なら、名前を main に変えてから push する。
git branch -M main
git push -u origin maingit branch -M はブランチの名前を変える(git-branch(新しいタブで開く))。
手元の名前を変えたくなければ、送り先の名前だけを指定する。
git push -u origin HEAD:main: の左が手元の送るもの、右がリモートでの名前である(git-push(新しいタブで開く))。
この形では HEAD -> main で送られ、手元の master が origin/main を追うようになった。
3. 手元にある名前を確かめる
git branch
git tag一覧に出た名前を、そのとおりに push に書く。
タグを送るときは、先に git tag v1.0.0 でタグを作っておく。
よくある原因
- まだコミットしていない。
git initの直後はブランチ名だけが決まっていて、ブランチの実体は最初のコミットで作られる。git statusがNo commits yetを返す状態では、どの名前で push してもこのエラーになる。 - ブランチ名が違う。
Git 2.54.0 でinit.defaultBranchを設定せずにgit initすると、最初のブランチはmasterになった(Git 3.0 でmainに変わると hint が出る)。
この状態でコミットしてからgit push -u origin mainと打っても、手元にmainが無いのでこのエラーになった。 - 名前を打ち間違えている。
git push origin mianのような誤字や、まだ作っていないタグv1.0.0を指定したときも、同じ文言でmianやv1.0.0の部分だけが変わる。