git checkout:路径未匹配
快速摘要
你让 git checkout 切换到一个不存在的文件或分支 —— git 报告 'pathspec did not match any file(s) known to git'。
为什么发生
分支名拼写错误,或者该分支从未在本仓库或远程创建过
你尝试 checkout 的文件路径在当前提交树中不存在
在尝试本地 checkout 远程分支之前忘记先 fetch 远程分支
最小示例
✗ 错误代码
git checkout feature/login # error: pathspec 'feature/login' did not match✓ 修复代码
git fetch origin
git checkout -b feature/login origin/feature/login # creates local tracking branch先 fetch 更新远程跟踪引用,然后创建跟踪远程分支的本地分支。
如何诊断
运行 git branch -a 列出所有本地和远程分支,确认准确的分支名
运行 git ls-files 检查文件路径是否在仓库索引中
运行 git fetch --all 更新远程跟踪分支后重试 checkout
如何修复
更正分支名拼写,或先用 git branch 或 git checkout -b 创建分支
先 git fetch origin 获取远程分支,再用 git checkout -b local-name origin/remote-name 创建本地跟踪分支
如果文件在历史提交中存在过,使用 git checkout <commit> -- <file> 从指定提交恢复
如何预防
经常运行 git branch -a 查看可用分支,避免分支名拼写错误
在 shell 中设置分支自动补全,防止拼写错误
相关资源
相关术语
相关课程
- git checkout
学习如何切换分支和恢复文件。