pathspec did not match anyの直し方｜git

error: pathspec 'feature/login' did not match any file(s) known to git は、git が、指定した名前を「ブランチ」としても「ファイル」としても見つけられなかったときのエラーです。 pathspec は「ファイルのパスの指定」という意味です。

git checkout は、ブランチの切り替えと、ファイルを元に戻す作業の両方に使います。 ブランチ名が見つからないと、ファイル名として探し、それも無いのでこのエラーになります。

確認環境：git 2.43.0（Linux）。リモートのリポジトリと、2つのクローンを作って再現しました（確認日 2026年10月11日）。

原因① リモートのブランチを、まだ fetch していない（一番多い）

同僚が feature/login ブランチを push したあと、自分のクローンで切り替えようとしました。

$ git checkout feature/login
error: pathspec 'feature/login' did not match any file(s) known to git

$ git switch feature/login
fatal: invalid reference: feature/login

$ git branch -r
  origin/HEAD -> origin/main
  origin/main                      ← origin/feature/login がまだ無い

自分のクローンは、リモートに新しいブランチができたことを、まだ知りません。 git fetch で、リモートの情報を取ってきます。

$ git fetch
$ git checkout feature/login
Switched to a new branch 'feature/login'
branch 'feature/login' set up to track 'origin/feature/login'.

fetch のあとは、同じコマンドで切り替えられました。 git の公式ドキュメントでは、指定したブランチが手元に無くても、同じ名前のブランチが1つのリモートにだけあれば、そのリモートのブランチを追跡するブランチを作って切り替える、と説明されています。fetch と pull の違いは、既存の記事「git fetchとpullの違い｜図解とpull --rebaseの使い分け」で扱っています。

git switch では、エラー文が違う

git switch はブランチの切り替えだけをするコマンドなので、ファイル名として探さず、「そのブランチは無い」と表示されます。 原因は同じです。

原因② 名前の打ち間違い・大文字小文字

ブランチ名は大文字小文字を区別しました。 git branch -a で、手元とリモートのブランチの一覧を表示し、正しい名前をコピーします。

git branch -a            # 手元とリモートのブランチの一覧
git branch -r | grep login

原因③ まだ追跡していないファイルを、元に戻そうとした

new.txt を作ったばかりで、まだ一度も add していない状態で試しました。

checkout --・restore は「git に記録されている版に戻す」コマンドなので、一度も記録していないファイルは戻せません。 公式ドキュメントでも、git checkout -- ファイル はインデックス（add した状態）の版でファイルを置き換える、と説明されています。まだ追跡していないファイルを消したいときは、ふつうに削除するか、git clean を使います。

原因④ Windows の cmd で、-m のメッセージが分かれる

C:\> git commit -m 'fix bug'

Microsoft の C++ のドキュメントでは、Windows のプログラムの引数は空白で区切られ、"（ダブルクォート）で囲んだ部分が1つの引数になると説明されています。'（シングルクォート）で囲む決まりは書かれておらず、コマンドプロンプト（cmd.exe）では 'fix と bug' の2つに分かれます。 確認環境で、同じように引数を2つに分けて渡すと、次のエラーになりました。

$ git commit -m "'fix" "bug'"
error: pathspec 'bug'' did not match any file(s) known to git

bug' がコミットするファイルの名前として扱われています。 メッセージは "（ダブルクォート）で囲みます。

git commit -m "fix bug"

原因⑤ git add のパスが違う

git add のパスは、今いるフォルダから見たパスです。src の中にいるなら git add a.txt と書きます。git status に表示されたパスを使うと間違えにくくなります。

error と fatal の違い

どちらも「その名前のファイル（ブランチ）が見つからない」という意味です。 表示の違いは、コマンドの違いです。

リモートが2つあるとき

origin と upstream の両方に feature/login があるとき、git checkout feature/login は次のように止まりました。

fatal: 'feature/login' matched multiple (2) remote tracking branches

どちらのリモートのブランチか決められないためです。 git switch -c feature/login --track origin/feature/login のように、リモートを指定すると切り替えられました。公式ドキュメントによると、設定 checkout.defaultRemote=origin で、優先するリモートを決めることもできます。

確認の手順（チェックリスト）

よくある質問

Q. fetch したのに、まだ切り替えられません。 A. git branch -r にそのブランチがあるかを確かめます。無ければ、相手がまだ push していないか、別のリモートに push しています。あるのに切り替えられないなら、名前の打ち間違いか、上の「リモートが2つあるとき」に当たります。

まとめ

• git が、ブランチとしてもファイルとしても見つけられなかったエラー
• 一番多いのは リモートのブランチを fetch していない。git fetch してから checkout
• まだ add していないファイルは、checkout --・restore で戻せない
• Windows の cmd では -m 'msg' が分かれる。" で囲む
• git switch では invalid reference と表示される

参考・出典

確認日はいずれも 2026年10月11日です。

• Git ドキュメント「git-checkout」：https://git-scm.com/docs/git-checkout
• Microsoft Learn「main function and command-line arguments」：https://learn.microsoft.com/en-us/cpp/cpp/main-function-command-line-args

株式会社RJC ― SI事業・SES事業・AI駆動開発。RJCは一緒に成長を楽しめる会社です。