如何排查并解决Git中无效路径错误问题？

本文共计946个文字，预计阅读时间需要4分钟。

Windows系统遇到错误invalid path，通常是Git拒绝检查某些文件路径——这不是网络或权限问题，而是NTFS文件系统层面的硬性截断。核心原因可能是一个：

为什么 git clone 后只有 .git 文件夹

这是最典型的表征。Git 已完成对象下载（Clone succeeded），但 checkout 阶段失败，所以工作区空空如也。背后机制是：core.protectNTFS 默认为 true，Git 会主动跳过所有违反 NTFS 规则的路径（比如含保留名、双斜杠、非法字符等），且不报具体错误类型，只笼统提示 invalid path。

• 常见触发路径：con.java、aux.c、prn.txt、folder//file、file:、file?
• 注意：Windows 不区分大小写，CON.java 和 con.java 效果一样
• git status -s 会显示所有文件为 D（deleted），其实是“从未被创建”，不是真删了

关闭 core.protectNTFS 是最快验证方式

临时禁用保护机制，能立刻判断是否为 NTFS 兼容性问题。