本质是windows默认260字符路径限制(max_path)与深层目录叠加导致检出失败,必须系统层解除限制才能使git长路径配置生效;推荐专业版用组策略启用win32长路径并重启,家庭版则通过注册表修改longpathsenabled为1并重启验证。

Win11系统下Git克隆代码时提示“Filename too long”,本质是Windows默认启用的260字符路径长度限制(MAX_PATH)与深层目录结构叠加导致检出失败,必须在系统层解除该限制才能让Git长路径配置真正生效。
通过组策略启用Win32长路径(推荐,专业版/企业版)
第一步:按 Win + R 打开运行窗口,输入 gpedit.msc 并回车。若提示“找不到文件”,说明你使用的是Win11家庭版,请跳转至注册表方案。
第二步:依次展开左侧树形菜单:计算机配置 → 管理模板 → 系统 → 文件系统。
第三步:在右侧双击打开 “启用 Win32 长路径” 策略项,选择 “已启用”,点击“确定”保存。
这一步必须重启电脑才生效,否则Git仍会受制于旧路径限制——【不重启,所有后续Git配置都无效】。
通过注册表启用长路径(通用,家庭版适用)
方法一:管理员权限运行PowerShell,执行以下命令一键写入:
reg add "HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem" /v "LongPathsEnabled" /t REG_DWORD /d "1" /f
方法二:手动修改注册表(更直观):
按 Win + R 输入 regedit → 导航至 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem → 右键空白处新建一个 DWORD (32位) 值,命名为 LongPathsEnabled → 双击将其数值数据设为 1。
注意:注册表操作前建议先导出备份,但此路径下仅修改LongPathsEnabled一项极安全,误删其他键值才可能引发问题。
验证系统级长路径是否启用成功
重启电脑后,打开任意终端(CMD/PowerShell/Git Bash),运行:
fsutil behavior query disablelastaccess
只要返回结果中包含 LongPathsEnabled : 1,即表示系统已支持最长32767字符路径——【此值为0则未生效,需检查重启和注册表写入是否完成】。











