在 Windows 系统中使用 Git 时，遇到 Filename too long 错误通常是由于系统默认的路径长度限制（260 字符）导致的。以下是综合多种场景的解决方案：
一、快速解决方法
- 启用 Git 长路径支持
通过 Git 配置命令允许处理超长文件名：
git config --system core.longpaths true
- 适用场景：全局生效，适用于所有仓库[[1][3][7][9][11][13][14]。
- 注意：若使用
--system参数，需以管理员权限运行 Git Bash 或命令行。
- 仅针对当前仓库配置
git config core.longpaths true
- 适用场景：仅当前仓库生效，避免全局修改[[3][7][9]。
二、系统级解决方案（Windows 专业版/企业版）
-
启用 Windows 长路径支持
-
按
Win + R输入gpedit.msc→ 进入 计算机配置 > 管理模板 > 系统 > 文件系统。 -
双击 启用 Win32 长路径 → 选择 已启用 → 保存[[10][14]。
-
修改注册表（通用版）
-
按
Win + R输入regedit→ 定位到：HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem -
修改
LongPathsEnabled的值为1→ 重启系统生效[[10][14]。
三、其他场景的适配方案
- 缩短文件路径
- 操作：将仓库克隆到更短的根路径（如
C:\git），避免多层嵌套目录[[5][9][14]。 - 示例：
git clone https://github.com/xxx.git C:\git\project
- 重新克隆已存在的仓库
若配置后仍报错，可能是历史缓存导致，需删除原仓库重新克隆：
rm -rf project # 删除旧仓库
git clone https://github.com/xxx.git # 重新克隆[[9][12]
- 使用管理员权限操作
- 场景：当 Git 操作涉及系统保护目录（如
Program Files）时，需以管理员身份运行 Git[[1][10]。
四、注意事项
- Windows 家庭版限制：
家庭版无法通过组策略修改路径限制，需通过注册表或第三方工具（如微软官方提供的长路径补丁）[[10]。 - IDE 兼容性：
IntelliJ IDEA、VS 等工具可能需单独配置 Git 路径或重启生效[[9][12]。 - 文件系统兼容性：
确保存储仓库的分区格式为 NTFS（FAT32 不支持长路径）[[5][10]。
五、验证是否生效
git config --get core.longpaths # 返回 true 表示配置成功
git status 或 git pull # 观察是否仍报错
通过以上方法可覆盖 90% 的 Windows Git 长路径问题，推荐优先尝试 快速解决方法 或 系统级配置。更多细节可参考 。
)