克隆私有Git仓库提示路径无效，但路径无非法字符如何解决？

• 检查文件名中的不可见字符：有些字符（如空格、制表符、Unicode控制字符）肉眼难以察觉，但会导致路径无效。在原仓库中执行以下命令排查：

  • git ls-files --stage | grep SubstrateCulturesOverview.tsx：查看Git记录中的文件名是否存在异常字符
  • cat -A frontend/src/pages/subjects/SubstrateCulturesOverview.tsx：显示文件中的所有不可见字符
    若发现异常，重命名文件并提交修改后重新克隆。

• 排查跨平台兼容性问题：

  • 文件名末尾可能存在空格：在Linux/macOS下允许文件名以空格结尾，但Windows会判定为无效路径，需在原仓库重命名去掉末尾空格
  • 路径长度超限：Windows默认限制路径总长度为260字符，若目标路径过长，可缩短本地克隆路径，或在Windows系统中开启长路径支持（通过组策略或注册表修改）

• 调整Git配置：Windows环境下Git默认开启core.protectNTFS配置，会拦截可能在NTFS文件系统中存在问题的文件名。可临时关闭该配置后再克隆：

  git config --global core.protectNTFS false
  

  克隆完成后建议恢复配置：

  git config --global core.protectNTFS true
  

• 检查仓库完整性：若以上方法无效，可能是原仓库中该文件对象损坏。在原仓库执行git fsck检查仓库完整性，修复后重新推送至远程仓库，再尝试克隆。

内容的提问来源于stack exchange，提问作者The Candy King