git拉取代码时出现Filename too long错误&Git处理长路径

背景

git拉取代码时出现Filename too long错误

现象

如下：
$ git checkout .
error: unable to create file boot-starters/permission-access-security-service-boot-starter/src/main/java/cn/gzs***/basic/system/platform/starter/permission/access/resource/fetch/PermissionReso***chBaseController.java: Filename too long
Updated 1 path from the index

解决

设置全局变量global core.longpaths为true

git config --global core.longpaths true

设置后查看

git config --list

如果需要取消

git config --global --unset core.longpaths

解释

当在Windows系统上使用Git时，文件路径的长度通常受到260个字符的限制。这意味着如果文件路径超过了这个限制，Git将无法正常处理这些文件。但是，通过运行"git config --global core.longpaths true"命令，你可以将"core.longpaths"配置选项设置为"true"，从而告诉Git允许处理超过260个字符的文件路径。

这个命令中的"–global"选项表示将该配置选项设置为全局配置，这意味着它将适用于你的所有Git仓库。如果你只想在特定的仓库中启用长路径支持，可以省略"–global"选项，并在特定仓库的目录中运行相同的命令。

启用"core.longpaths"选项后，Git将能够处理长路径，使你能够在Windows系统上使用更长的文件路径。这对于某些项目或特定的文件结构可能非常有用。但需要注意的是，启用长路径支持可能会导致一些旧的或不兼容的工具无法正常工作，因为它们可能无法处理超过260个字符的文件路径。因此，在启用长路径支持之前，请确保你的工具和环境能够适应这种变化。