Windows下Git克隆仓库后checkout报错：路径末尾含空格无效

问题原因 #

Windows文件系统不允许文件名或路径末尾包含空格，但Git默认遵循Unix文件系统规则，允许这类路径存在。克隆仓库后执行git checkout时，Git尝试在Windows上创建末尾带空格的文件，触发系统限制导致报错。

解决步骤 #

1. 关闭Git的NTFS路径保护
   在Git Bash中执行以下命令，允许Git处理不符合NTFS规范的路径：
   git config core.protectNTFS false

2. 重新执行Checkout操作
   再次运行你需要的checkout命令，比如切换分支或恢复文件：
   git checkout <目标分支名>

3. 修复带空格的路径
   找到报错中提到的路径app/code/Catwalk/Producteditor/etc/adminhtml/routes.xml ，手动去掉路径末尾的空格，将文件重命名为app/code/Catwalk/Producteditor/etc/adminhtml/routes.xml

4. 提交修复到仓库
   将修改提交到Git仓库，避免后续其他用户克隆或checkout时遇到同样问题：

git add .
git commit -m "Fix invalid file path: remove trailing space from routes.xml"

注意事项 #

• 跨平台协作时，尽量避免创建末尾带空格、特殊字符的路径，减少兼容性问题
• 如果是团队项目，建议同步告知其他成员修复后的路径，或让他们临时开启core.protectNTFS false配置完成checkout

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