Git error invalid path报错问题及解决方式实用指南

佚名 2026-09-29 13:00:02

平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“Git error invalid path报错问题及解决方式”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序，把思路、关键写法和容易踩坑的地方讲清楚，便于大家直接对照操作。

问题情况

情形 1：采用 git clone 后，拉取的文件夹中只有 .git 文件夹，其他内容均没有拉下来。采用 git status -s 命令，能够看到所有文件都显示已被删除的状态。

情形 2：本地在切换分支时，出现如下所示报错信息，随后分支切换失败：

error: invalid path 'folder_1/....../name_1.txt'
error: invalid path 'folder_1/....../name_2.txt'
error: invalid path 'folder_1/....../name_3.txt'
error: invalid path 'folder_1/....../name_4.txt'

问题原因

从实现思路看，代码中包含 NTFS 文件系统不兼容的文件名。（源代码可能是在 Mac 或 Linux 等其他系统下开发的）

实际处理时，Git 在 Windows 下默认开启了 NTFS 保护机制，导致包含不满足 NTFS 文件名的项目无法被成功拉取，且无法切换到这些不满足 NTFS 文件名规范的文件夹中。

解决方法

关闭 NTFS 保护机制的设置，操作命令如下所示：

git config core.protectNTFS false

关于这个设置，Git 的描述如下所示：

If set to true, do not allow checkout of paths that would cause problems with the NTFS filesystem, e.g. conflict with 8.3 “short” names. Defaults to true on Windows, and false elsewhere.

开启该设置后，执行 git checkout 命令即可。

实际处理时，在 checkout 时会打印这些文件拉取失败的日志，但能够成功拉取其他文件：

error: unable to create file folder_1/....../name_1.txt: No such file or directory
error: unable to create file folder_1/....../name_2.txt: No such file or directory
error: unable to create file folder_1/....../name_3.txt: No such file or directory
error: unable to create file folder_1/....../name_4.txt: No such file or directory

在拉取完成后，执行 git status -s 命令后，会显示这些不满足 NTFS 文件名的文件均为被删除的状态。