执行git checkout命令报文件缺失错误，但远程端存在该文件是什么原因？

导致该报错的核心原因是你本地Git存储的远程分支信息中，不存在你指定路径下的对应文件，具体可按以下顺序排查：

• 文件路径填写错误
  Git会以你执行命令时的当前工作目录为基准匹配文件路径，直接填写文件名仅当文件在当前工作目录下时才生效。如果文件存放在子目录中，需要填写从仓库根目录出发的完整相对路径，例如文件存放在src/ViewModels/目录下，命令需要写为：

git checkout origin/master -- src/ViewModels/FormFieldHistoryViewModel.cs

你也可以先切换到文件所在的对应目录，再执行检出命令。

• 分支名称不匹配
  目前很多仓库的默认主分支已从master改为main，如果你在Azure Devops上查看的是main分支的文件，本地仍然使用origin/master作为检出源会找不到对应文件。你可以先确认目标文件所在的远程分支名称，替换命令中的分支参数即可。
• 本地远程仓库引用异常
  1. 先确认本地origin对应的仓库地址是否和你查看的Azure Devops仓库一致，执行命令：

  git remote -v
  

  核对返回的fetch地址与Azure仓库地址是否匹配。
  2. 普通fetch可能没有清理过时的远程分支缓存，执行以下命令强制刷新远程分支引用：

  git fetch origin --prune
  

• 文件名大小写不匹配
  Git对文件名大小写敏感，而Windows/macOS系统默认对文件名大小写不敏感，如果你填写的文件名大小写和远程仓库的实际文件名存在差异，也会触发该报错，需要严格匹配远程文件的大小写拼写。

验证方法 #

你可以执行以下命令，查看本地存储的对应远程分支中是否存在目标文件：

# 把master替换为实际的远程分支名
git ls-tree origin/master --name-only | findstr FormFieldHistoryViewModel.cs

如果命令无返回结果，说明你本地存储的对应远程分支中确实不存在该文件，按上述步骤排查分支、仓库地址、路径问题即可。

内容的提问来源于stack exchange，提问作者Morks