Git error Filename too long
快速解决方法
启用 Git 长路径支持 --system 参数 需以管理员权限运行 Git Bash 或命令行
通过 Git 配置命令允许处理超长文件名:
git config --system core.longpaths true
适用场景:全局生效,适用于所有仓库
对当前仓库配置
git config core.longpaths true
适用场景:仅当前仓库生效,避免全局修改
系统级解决方案(Windows 专业版/企业版)
启用 Windows 长路径支持
按 Win + R 输入 gpedit.msc → 进入 计算机配置 > 管理模板 > 系统 > 文件系统
双击 启用 Win32 长路径 → 选择 已启用 → 保存
修改注册表(通用版)
按 Win + R 输入 regedit → 定位到:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\FileSystem
修改 LongPathsEnabled 的值为 1 → 重启系统生效[[10][14]。
若配置后仍报错,可能是历史缓存导致,需删除原仓库重新克隆:
rm -rf project # 删除旧仓库
git clone https://github.com/xxx.git # 重新克隆
使用管理员权限操作
场景:当 Git 操作涉及系统保护目录(如 Program Files)时,需以管理员身份运行 Git
注意事项
Windows 家庭版限制:
家庭版无法通过组策略修改路径限制,需通过注册表或第三方工具(如微软官方提供的长路径补丁)
IDE 兼容性:
IntelliJ IDEA、VS 等工具可能需单独配置 Git 路径或重启生效
文件系统兼容性:
确保存储仓库的分区格式为 NTFS(FAT32 不支持长路径)
验证是否生效
git config --get core.longpaths # 返回 true 表示配置成功
git status 或 git pull # 观察是否仍报错
上一篇: 网页中展示数学公式 KaTeX
下一篇: AI客服系统
