できない.dev

git「src refspec main does not match any」の原因と直し方

src refspec main does not match any は、コミットを 1 つ作るか、手元のブランチ名に合わせて push すれば直る。
push に書いた名前のブランチやタグが手元に無いと出る。

公開: 更新:

症状できない · exit 1
git push -u origin main
error: src refspec main does not match any
error: failed to push some refs to '../remote.git'
解決後できた · exit 0
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/git Alpine Linux v3.24
バージョン
  • Git 2.54.1

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. 最初のコミットを作ってから push する

git add .
git commit -m "first commit"
git push -u origin main

git 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 main

git 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 でタグを作っておく。

よくある原因

  1. まだコミットしていない。
    git init の直後はブランチ名だけが決まっていて、ブランチの実体は最初のコミットで作られる。
    git status が No commits yet を返す状態では、どの名前で push してもこのエラーになる。
  2. ブランチ名が違う。
    Git 2.54.0 で init.defaultBranch を設定せずに git init すると、最初のブランチは master になった(Git 3.0 で main に変わると hint が出る)。
    この状態でコミットしてから git push -u origin main と打っても、手元に main が無いのでこのエラーになった。
  3. 名前を打ち間違えている。
    git push origin mian のような誤字や、まだ作っていないタグ v1.0.0 を指定したときも、同じ文言で mian や v1.0.0 の部分だけが変わる。