Git 解决“Filename too long”问题

在 Windows 系统中使用 Git 时，遇到 Filename too long 错误通常是由于系统默认的路径长度限制（260 字符）导致的。以下是综合多种场景的解决方案：

一、快速解决方法

1. 启用 Git 长路径支持
   通过 Git 配置命令允许处理超长文件名：

git config --system core.longpaths true 

• 适用场景：全局生效，适用于所有仓库[[1][3][7][9][11][13][14]。
• 注意：若使用 --system 参数，需以管理员权限运行 Git Bash 或命令行。

2. 仅针对当前仓库配置

git config core.longpaths true 

• 适用场景：仅当前仓库生效，避免全局修改[[3][7][9]。

二、系统级解决方案（Windows 专业版/企业版）

1. 启用 Windows 长路径支持

2. 按 Win + R 输入 gpedit.msc → 进入 计算机配置 > 管理模板 > 系统 > 文件系统。

3. 双击 启用 Win32 长路径 → 选择 已启用 → 保存[[10][14]。

4. 修改注册表（通用版）

5. 按 Win + R 输入 regedit → 定位到：

   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem 
   

6. 修改 LongPathsEnabled 的值为 1 → 重启系统生效[[10][14]。

三、其他场景的适配方案

1. 缩短文件路径

• 操作：将仓库克隆到更短的根路径（如 C:\git），避免多层嵌套目录[[5][9][14]。
• 示例：

  git clone https://github.com/xxx.git C:\git\project 
  

2. 重新克隆已存在的仓库
   若配置后仍报错，可能是历史缓存导致，需删除原仓库重新克隆：

rm -rf project  # 删除旧仓库 
git clone https://github.com/xxx.git  # 重新克隆[[9][12]

3. 使用管理员权限操作

• 场景：当 Git 操作涉及系统保护目录（如 Program Files）时，需以管理员身份运行 Git[[1][10]。

四、注意事项

1. Windows 家庭版限制：
   家庭版无法通过组策略修改路径限制，需通过注册表或第三方工具（如微软官方提供的长路径补丁）[[10]。
2. IDE 兼容性：
   IntelliJ IDEA、VS 等工具可能需单独配置 Git 路径或重启生效[[9][12]。
3. 文件系统兼容性：
   确保存储仓库的分区格式为 NTFS（FAT32 不支持长路径）[[5][10]。

五、验证是否生效

git config --get core.longpaths  # 返回 true 表示配置成功 
git status 或 git pull           # 观察是否仍报错 

通过以上方法可覆盖 90% 的 Windows Git 长路径问题，推荐优先尝试 快速解决方法 或 系统级配置。更多细节可参考 。