Ubuntu20.04系统git配置HTTPS+PAT认证失败报错如何解决?
问题根因说明
你遇到的报错和PAT有效性无关,核心是系统更新后Git Credential Manager (GCM) 运行依赖损坏。报错中的GitHub.UI.deps.json、libHarfBuzzSharp.so缺失都是GCM的报错,GCM作为git的凭据助手无法正常启动,不能读取存储的PAT,最终触发认证失败、仓库不存在的错误。
排查验证步骤
- 查看当前git配置的凭据助手:执行
git config --global credential.helper,如果输出包含git-credential-manager-core、manager-core相关内容,即可确认问题来源 - 手动运行GCM验证报错:执行
git credential-manager-core --version,如果输出和你遇到的HarfBuzzSharp.NativeAssets.Linux缺失报错一致,即可完全确认依赖损坏问题
解决方法
方案一:修复GCM依赖(保留原有认证逻辑)
- 先安装缺失的系统依赖:执行
sudo apt update && sudo apt install libharfbuzz0b libfreetype6 fontconfig - 若安装依赖后仍然报错,直接重装GCM即可:
- 卸载当前损坏的GCM版本:
sudo apt remove -y git-credential-manager-core - 下载Git Credential Manager官方提供的Ubuntu 20.04对应deb安装包,执行
sudo dpkg -i <你的deb包本地路径>完成安装 - 重新配置凭据助手:
git config --global credential.helper manager-core
- 卸载当前损坏的GCM版本:
- 配置完成后执行任意需要认证的git操作(如git pull),弹出认证窗口时重新输入你的PAT即可正常使用
方案二:切换为轻量本地凭据存储(无需GCM)
如果不需要GCM的额外功能,可以直接切换为更稳定的本地文件存储方式:
- 执行
git config --global credential.helper store - 执行一次git pull,按提示输入GitHub用户名和PAT,凭据会加密存储在
~/.git-credentials文件中,后续操作无需重复输入
内容的提问来源于stack exchange,提问作者Mx.Wolf
相关产品推荐
相关产品推荐

