快捷導(dǎo)航

git大倉庫拉取卡頓問題排查與解決方法

更新時間：2026年05月19日 09:22:36 作者：小小小小宇

在大倉庫中執(zhí)行 git fetch 或 git pull 遲遲沒有反應(yīng),通常是由網(wǎng)絡(luò)問題、數(shù)據(jù)量過大導(dǎo)致內(nèi)存/緩沖區(qū)溢出、或認(rèn)證卡死引起的, 下面我們就來看如何排查和解決吧

第一步：開啟調(diào)試模式（找出卡在哪）

不要干等，先讓 Git 告訴你它在干什么。在命令前加上環(huán)境變量開啟詳細(xì)輸出：

如果是 HTTPS 鏈接：

GIT_TRACE=1 GIT_CURL_VERBOSE=1 git fetch origin master -v

如果是 SSH 鏈接：

GIT_TRACE=1 GIT_SSH_COMMAND="ssh -v" git fetch origin master -v

根據(jù)輸出的日志，你可以清楚地看到是卡在連接服務(wù)器（網(wǎng)絡(luò)問題）、卡在鑒權(quán)（密碼/密鑰問題）、還是卡在下載對象（倉庫太大）。

第二步：針對大倉庫的專項優(yōu)化

如果日志顯示已經(jīng)連上服務(wù)器，但卡在 Receiving objects 或長時間無響應(yīng)，說明倉庫太大，可以嘗試以下方法：

1. 增大 Git 的通信緩沖區(qū)（最常見的解決方法）

大倉庫拉取時很容易因為超出默認(rèn)緩存大小而斷開或假死。將緩沖區(qū)調(diào)大到 500MB 或 1GB：

git config --global http.postBuffer 524288000
# 如果還不行，可以嘗試設(shè)為 1GB (1048576000)

2. 淺克隆/淺拉取（只拉取最新代碼）

如果你不需要全部的歷史記錄，只想要最新的代碼，可以限制深度：

git fetch origin master --depth 1

3. 無 Blob 拉取（Partial Clone）

這是 Git 較新的特性，特別適合大倉庫。它會拉取所有的提交歷史，但不下載具體的文件內(nèi)容（Blob），只有在你 checkout 到具體文件時才按需下載：

git fetch origin master --filter=blob:none

4. 關(guān)閉/調(diào)整壓縮（緩解 CPU 和內(nèi)存壓力）

如果你的電腦在處理巨型壓縮包時卡死，可以嘗試降低壓縮率：

git config --global core.compression 0

第三步：排查網(wǎng)絡(luò)與連接問題

如果日志顯示卡在 Connecting to...，那就是網(wǎng)絡(luò)問題。

1. 設(shè)置代理（如果訪問的是 GitHub ）

如果你本地開啟了科學(xué)上網(wǎng)工具，Git 默認(rèn)是不會走代理的，需要手動設(shè)置（假設(shè)你的代理端口是 7890）：

# HTTPS 協(xié)議設(shè)置代理
git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

# 取消代理的命令（備用）
# git config --global --unset http.proxy
# git config --global --unset https.proxy

2. 切換傳輸協(xié)議（SSH vs HTTPS）

如果你用的是 HTTPS (https://github.com/...) 卡住，嘗試換成 SSH 協(xié)議 (git@github.com:...)。
反之亦然。有時候公司網(wǎng)絡(luò)或運營商會限制某一種協(xié)議。
修改方法：git remote set-url origin <新的SSH或HTTPS地址>

第四步：排查認(rèn)證卡死問題

有時候 Git 是在等待你輸入密碼或確認(rèn) SSH 密鑰，但提示框沒彈出來或者被隱藏了。

測試 SSH 連接：如果你用的是 SSH，單獨測一下能不能連通：

ssh -T git@github.com  # 如果是 GitLab 或 Gitee，替換為對應(yīng)的域名

如果這里卡住，說明是 SSH 密鑰配置錯誤或端口被封。

憑據(jù)管理器卡死：如果你用的是 Windows，Windows Credential Manager 有時會彈窗失敗導(dǎo)致后臺掛起。嘗試在任務(wù)管理器中強(qiáng)制結(jié)束 git-credential-manager.exe 或 ssh-agent.exe，然后重試。

總結(jié)建議操作順序

先跑 GIT_TRACE=1 git fetch origin master -v 看日志。
如果是網(wǎng)絡(luò)不通，配置代理或切換 SSH/HTTPS。
如果是倉庫太大拉不動，依次執(zhí)行：改大 Buffer -> 加入 --filter=blob:none 參數(shù) -> 加入 --depth 1 參數(shù)。

到此這篇關(guān)于git大倉庫拉取卡頓問題排查與解決方法的文章就介紹到這了,更多相關(guān)git大倉庫拉取卡頓解決內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: