Git checkout及clone公司大型远程仓库卡在100%进度无响应问题求助

问题描述 #

操作公司125GB级大型远程仓库时，checkout任意分支、clone仓库都会在文件更新进度达到100%后无报错挂起，该问题仅在当前Windows 10工作设备上复现，小体积GitHub仓库操作正常，其他设备/同事操作该仓库均无异常。

根因排查方向 #

排除通用Git功能故障后，问题收敛到当前设备的环境配置适配问题，优先排查三类异常：

• Windows系统针对长路径、大文件的默认限制
• 安全软件、网络代理对大批量文件操作的拦截
• Git默认配置未适配100GB级超大仓库的IO开销

解决方案（按优先级执行） #

1. 调整Git全局配置适配Windows与大仓库场景 #

执行以下命令修改配置后复测：

# 开启Windows长路径支持（适配Windows 10 1607及以上版本）
git config --system core.longpaths true
# 调大HTTP传输缓冲区，匹配大文件传输需求
git config --global http.postBuffer 524288000
# 关闭自动换行符转换，避免全量文件校验的额外开销
git config --global core.autocrlf false
# 启用文件系统缓存，降低大仓库IO操作耗时
git config --global core.fscache true

2. 排查拦截类软件规则 #

• 临时关闭Windows Defender实时保护、企业终端安全软件（EDR/XDR）的文件扫描功能，复测验证是否为安全扫描阻塞了全量文件写入操作，验证通过后将本地仓库存放目录加入安全软件白名单。
• 切换办公内网直连，绕过VPN/企业代理复测，避免代理的流量清洗规则阻塞文件校验阶段的请求。
• 确认本地仓库目录未加入OneDrive、企业云盘等同步目录，避免同步进程抢占文件锁导致Git操作挂起。

3. 采用大仓库优化操作模式 #

针对100GB级以上超大仓库，推荐使用部分克隆降低单次操作开销：

# 仅克隆最新提交的文件，不拉取历史版本的大二进制文件
git clone --filter=blob:none <仓库HTTPS地址>
# 按需开启稀疏检出，仅拉取需要操作的目录
git sparse-checkout init --cone
git sparse-checkout set <需要操作的目录路径>

4. 校验磁盘状态 #

确认存放仓库的SSD预留至少400GB以上可用空间，且已完成4K对齐，避免磁盘空间分配、碎片整理操作阻塞写入流程。

内容的提问来源于stack exchange，提问作者Ilia