快速修复
# 一键:清掉失效 git 代理,然后直接 pip 安装(不需要 clone 源码)
git config --global --unset http.proxy && git config --global --unset https.proxy && pip install deepcode-hku
你会遇到什么
git clone https://github.com/HKUDS/DeepCode.git 反复报连接被重置 / 超时。你以为换个网络就行,结果换完还是断。
本文路径:快速修复(30 秒一段命令)→ 一步步排查(可跳读)→ 原理与变体(症状/原因/证据)。赶时间直接跳到「快速修复」。
为什么会这样
两个常见原因:
| 原因 | 说明 |
|---|---|
| 国内直连 GitHub 不稳定 | 大仓库 clone 中途被重置(连通性记录) |
| 本地配置了失效的 Git 代理 | 代理已挂但 http.proxy 还留着,git 走死代理必失败 |
还有一个关键认知:你根本不需要 clone——只想用工具直接 pip 安装即可。
git 的传输路径是“代理配置 → TCP 连接 → TLS 握手 → 数据流”四段,报 Connection reset by peer 时前三段已经走完、在数据流阶段被对端掐断——说明网络是通的,断的是“传输通道稳定性”,不是“连不上”。
两个常见根因对应两段:本地失效代理(git 读取 http.proxy/https.proxy 全局配置,把流量交给一个已经挂掉的代理,代理直接拒绝/重置)和直连出口不稳(大仓库长连接被中间设备重置)。
这解释了为什么“换个网络还是断”:如果根因是失效代理,换网络没用,代理配置还在;所以排查顺序固定:先 git config --get http.proxy 确认有没有残留代理并清掉(改配置层),再换网络试(改物理层),最后才考虑源头。还有个更省事的确定性选择:装工具 ≠ 装源码——只想用工具就 pip install,把整个 clone 环节跳过,问题直接不存在。
一步步来
1. 清代理 — 必做
git config --global --unset http.proxy
和 git config --global --unset https.proxy,再检查系统代理环境变量(env | grep -i proxy)。
2. 换网络/热点重试 — 必做
换网络或错峰重试;热点网络常常能绕开出口问题。
3. 只想用工具:直接 pip 安装 — 必做
pip install deepcode-hku
不需要 clone 源码(本市场收录走 PyPI 路径)。
怎么确认修好了
clone 或 pip 安装正常完成:
git clone ... → 正常完成(或)
pip install deepcode-hku → Successfully installed deepcode-hku
不再出现 Connection reset by peer。
其它环境的表现
| 环境 | 说明 |
|---|---|
| 失效代理 | --unset 后恢复(CSDN 案例) |
| 直连不稳 | 换网络/热点/错峰 |
| 只要工具 | pip 路径,跳过 clone |
| 国内连通性 | GitHub 直连风险见 |
症状
git clone https://github.com/HKUDS/DeepCode.git 反复报连接被重置 / 超时。
原因
国内直连 GitHub 不稳定;本地配置了失效的 Git 代理也会导致重置。
解法
- 清代理:
git config --global --unset http.proxy(与https.proxy),或检查系统代理环境变量。 - 换网络/热点重试;错峰重试。
- 只想用工具:直接用 pip 安装(路径 1),不需要 clone 源码。
验证证据
- 网页案例:CSDN(git clone 连接被重置 → 清 Git 代理/换热点,2026-06)。
- 本市场实测:收录走 PyPI 路径(不需要 clone);国内 GitHub 直连风险在连通性记录中标注。
适用工具 (1)
本问题方案已挂到下列工具的方案页——从工具页也能回到这里,双向可达。
deepcode来源与证据
← 多智能体编排 问题域 | 问题货架 | 遇到其它问题?去 问题空间 提交求助卡