WebStorm中Git pull卡住无法执行问题求助

问题现象 #

• WebStorm界面显示蓝色箭头提示分支可更新，但无法完成更新操作
• 手动执行git pull时所有分支均卡住
• 重启电脑无效，git checkout操作正常，无合并需求时git push正常
• 尝试rm -f .git/index.lock无效；执行git fsck && git gc --prune=now后出现大量错误
• 重启IDE仅解决过一次，之后问题复发

可能原因 #

• 远程仓库连接异常：Git拉取需与远程建立稳定连接，网络波动、远程端临时故障或本地Git远程配置错误都可能导致卡住
• 本地Git仓库损坏：git fsck出现大量错误说明本地对象数据库存在损坏，会干扰拉取这类读写仓库对象的操作
• WebStorm Git缓存冲突：IDE缓存的Git状态异常，可能导致状态显示错误并干扰拉取流程
• Git进程残留：异常退出的Git后台进程占用仓库资源，阻塞后续操作

解决步骤 #

1. 清理Git残留进程 #

先终止所有Git相关进程，释放资源：

# macOS/Linux
ps aux | grep git | grep -v grep | awk '{print $2}' | xargs kill -9

# Windows（PowerShell）
Get-Process git* | Stop-Process -Force

执行完毕后尝试git pull测试

2. 修复本地仓库损坏 #

• 先备份当前仓库（避免数据丢失）
• 执行以下命令逐步修复：

# 重置索引到当前HEAD状态
git reset --hard HEAD

# 更新远程分支并拉取完整对象
git remote update --prune
git fetch --all

# 再次检查仓库健康状态
git fsck

• 如果git fsck仍有大量错误，直接重新克隆远程仓库：

git clone <远程仓库URL> new-repo
# 将原仓库未提交文件复制到新仓库，重新提交推送

3. 重置WebStorm Git缓存 #

• 关闭WebStorm
• 删除对应版本的Git缓存目录：
  • macOS: ~/Library/Caches/JetBrains/WebStorm<版本号>/Git
  • Windows: C:\Users\<用户名>\AppData\Local\JetBrains\WebStorm<版本号>\Git
  • Linux: ~/.cache/JetBrains/WebStorm<版本号>/Git
• 重新打开WebStorm，重新关联Git仓库

4. 检查远程配置与网络 #

• 验证远程仓库配置正确性：

git remote -v

• 测试与远程仓库的连通性：

# SSH协议仓库
ssh -T git@<远程仓库域名>

# HTTPS协议仓库
curl -I <远程仓库HTTPS地址>

• 若网络不稳定，尝试切换网络（如WiFi转有线），或检查代理、防火墙是否阻止Git连接

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