【Ubuntu使用BUG】git clone 时卡在处理 delta 中: 100%（Resolving deltas: 100%）不动

问题现象

• git clone 下载对象完成后，终端长时间停在 Resolving deltas: 100%，没有下一步输出。
• 没有报错，但也不结束，看起来像死锁或无限等待。

产生原因

• 在 Linux 系统上，某些与网络相关的系统调用在处理主机名时，会反向查询主机名对应的 IP。
• 如果 /etc/hosts 中主机名没有映射到 127.0.0.1，或者被错误映射到其他 IP，可能导致 Git 在内部进行某些本地通信或安全校验时，等待一个无法正确回连的连接，表现为“卡死”。
• 这本质上不是 Git 的 bug，而是系统层面主机名解析配置不规范，影响了 Git 依赖的底层库（如 SSH、libcurl 或 GnuTLS）的正常握手或关闭流程。

解决办法

1. 获取当前主机名：

   hostname
   

2. 编辑 /etc/hosts：

   sudo nano /etc/hosts
   

3. 确保 127.0.0.1 一行包含主机名：

   127.0.0.1   localhost <主机名>
   

   或者插入一行：

   127.0.0.1   <主机名>
   

4. 验证：

   ping -c 2 <主机名>
   

   必须返回 127.0.0.1。
5. 重新执行 git clone，问题解决。

原理补充

• Resolving deltas 是 Git 在完成所有数据传输后，在本地重建完整对象的关键步骤。此时 Git 不再依赖远端网络，但会进行大量 I/O 和 CPU 操作。
• 为什么看似纯本地操作却受主机名影响？因为 Git 在某些编译版本中，会调用 libcurl 或 GnuTLS 进行最后的连接清理或证书校验，这些库在初始化或关闭会话时会调用 getaddrinfo 解析主机名。如果主机名解析异常，可能导致内部套接字无法正常关闭，线程陷入无限等待。
• 将主机名绑定到 127.0.0.1 保证所有本地回环查询都能即刻成功，不会出现 DNS 超时或路由异常。