WSL2环境下Gitlens拉取远程仓库时挂起问题排查求助

调试思路 #

• 启用Gitlens调试日志：打开VS Code设置，搜索gitlens.debug，勾选启用调试模式后重启VS Code。重现fetch挂起问题后，切换到「输出」面板，选择Gitlens日志分类，查看卡住的具体执行指令、报错信息，重点排查Git路径调用错误、认证环节阻塞两类问题。
• 验证环境变量一致性：分别在独立的WSL终端和VS Code内置WSL终端执行echo $SSH_AUTH_SOCK、which git，对比两次输出是否一致。如果VS Code侧输出不同，说明WSL远程会话没有加载到本地shell的环境变量，是导致挂起的核心原因。
• 排查仓库特殊配置：如果仅单个仓库出现该问题，进入仓库目录执行git config --list，检查是否配置了自定义代理、pre-fetch钩子等会阻塞fetch执行的规则。

可行解决方案 #

• 修复ssh-agent会话关联问题：在WSL的~/.bashrc（若使用zsh则修改~/.zshrc）文件末尾添加如下配置，让VS Code远程会话可以正确读取ssh-agent的授权信息：

export SSH_AUTH_SOCK=$(ls -t /run/user/$UID/keyring*/ssh 2>/dev/null | head -1)

修改完成后执行source ~/.bashrc（对应zsh执行source ~/.zshrc），重启VS Code后再测试fetch操作。

• 修正Git调用路径：将VS Code设置项gitlens.git.path的值修改为WSL终端执行which git输出的路径，避免Gitlens错误调用Windows端Git程序导致跨环境执行异常。
• 关闭Gitlens自动fetch：如果临时需要使用Gitlens功能，可以搜索设置项gitlens.autofetch，关闭所有自动fetch相关开关，需要同步远程状态时直接在VS Code内置终端执行git fetch，Gitlens会自动同步拉取后的最新状态。
• 更换Gitlens版本：当前使用的v11.6.0为较旧版本，可尝试升级到最新兼容版本，或降级到v11.5.x版本验证是否还会复现问题。
• 切换Git认证方式：如果当前使用SSH认证，可切换为HTTPS认证，使用Git凭据管理器存储访问凭据，规避ssh-agent关联异常问题。

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