当前位置:

首页 > 编程开发 > git配置GPG签名提交的方法【教程】

git配置GPG签名提交的方法【教程】

Git提交签名需GPG密钥、Git配置与密码管理对齐。常见失败原因:密钥邮箱与gituser.email不匹配,或未上传公钥至平台。需指定签名密钥、开启全局签名并设置GPG程序路径。pinentry弹窗问题可启用loopback模式。平台显示Verified需公钥与已验证邮箱一致。

本文目录

    Git提交签名这件事,还真不是“打开开关就完事”那么简单。先说一个判断:稳定运行的前提,是GPG密钥、Git配置、密码管理这三者必须对齐。如果只单独设了commit.gpgsign true,大概率会卡在输密码环节,或者提交上去后平台不认账。

    检查 GPG 是否就绪,密钥邮箱必须匹配

    签名失败最常见的原因,说起来其实挺基础:你生成的GPG密钥里,根本没有包含当前git config user.email所用的邮箱,或者这个邮箱压根没在GitHub/GitLab上验证过。这就好比拿错身份证去办业务,系统当然不认。

    • 先确认当前提交用的邮箱:跑一下 git config user.email
    • 再查本地密钥列表:gpg --list-secret-keys --keyid-format=long,重点看 uid 那一行是否含了上面的邮箱
    • 如果不匹配,要么重新生成密钥(gpg --full-generate-key),要么用 gpg --edit-key KEYID 把邮箱加进去
    • 最后把公钥导出:gpg --armor --export KEYID,然后复制粘贴到GitHub的Settings → SSH and GPG keys页面就行

    Git 得知道用哪个密钥,以及用哪个 GPG 程序

    光设个commit.gpgsign true远远不够,Git还需要知道“用谁签”和“谁来签”——尤其macOS或WSL环境下,很容易调错二进制文件。

    • 指定签名密钥:git config --global user.signingkey ABCDEF1234567890(换成你自己的密钥ID)
    • 打开全局签名开关:git config --global commit.gpgsign true
    • 显式指明GPG程序路径:git config --global gpg.program gpg,或者更稳妥地写成 /usr/bin/gpg
    • 如果你用的是较新macOS加GPG Suite,还可以加一句:git config --global gpg.ssh.allowedSignersFile ~/.gnupg/allowed_signers(这一步只涉及SSH签名场景)

    每次提交都弹密码框?或者直接报错?

    GPG默认每次签名都会唤起pinentry密码弹窗程序。可问题是,很多终端环境——比如VS Code内置终端、远程SSH会话——根本弹不出GUI窗口,结果就是卡住或报错gpg: signing failed: No pinentry。

    • 先检查是否启用了loopback模式:grep "pinentry-mode" ~/.gnupg/gpg.conf,确保里面有 pinentry-mode loopback
    • 重启agent让它生效:gpgconf --kill gpg-agent && gpgconf --launch gpg-agent
    • macOS用户建议直接装GPG Suite,它自动和系统钥匙串集成,体验好很多;Windows用户可以用Gpg4win自带的Kleopatra管理密码缓存
    • 测试下签名是否通:跑 echo test | gpg --clearsign 2>/dev/null,不报错就说明基本可用了

    签名成功≠平台显示Verified

    这里有个容易踩的坑:本地签名跑通了,不代表GitHub或GitLab就一定显示“Verified”。平台只认你账户里上传过的公钥,而且签名用的邮箱必须是平台已验证过的。

    • 推送后去GitHub仓库的Commits页面,点开最新提交,右上角有没有显示 Verified?没有的话,点进提交详情,再点“Verify signature”看看具体原因(最常见的就是邮箱不匹配或公钥没上传)
    • 也可以在本地命令行验证:git show -s --show-signature HEAD,输出里有 Good signature from 才算本地真的签成功了
    • GitLab要注意一个细节:它不查公钥服务器,只认你手动粘贴的公钥;而且密钥里必须至少有一个邮箱和GitLab账户绑定的已验证邮箱完全一致,一个字都不能差

    说到底,真正麻烦的从来不是敲几行配置命令,而是密钥的生命周期管理。比如密钥过期后忘了更新平台上的公钥,或者换公司邮箱了却没同步GPG uid——这些问题不会报错,只会让你的新提交悄悄变成Unverified,而你很可能两周后打开PR才注意到。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 git
    相关文章 更多
    git解决代码冲突的详细步骤与操作方法
    git解决代码冲突的详细步骤与操作方法

    遇到Git合并冲突别慌张,本文详解冲突产生的原因及标准处理流程,涵盖查看冲突文件、理解标记含义、手动修改代码及完成合并提交的完整步骤,助你高效解决协作开发中的代码冲突问题。

    git创建分支bip的命令及完整操作步骤
    git创建分支bip的命令及完整操作步骤

    想知道如何用Git创建名为bip的分支?本文提供清晰的命令行操作步骤,包括本地创建、切换分支以及推送到远程仓库的方法,适合初学者快速上手。

    GitLab新手创建项目并推送第一次提交的操作指南
    GitLab新手创建项目并推送第一次提交的操作指南

    本文指导GitLab新手完成创建项目并推送第一次提交的最小闭环。涵盖远程项目创建、本地仓库初始化、添加远程地址及执行git push。重点说明HTTPS与SSH认证差异、分支名(master/main)核对及提交验证标准,确保远程仓库真正建立。

    在小说搜搜找不到想看的小说怎么办?小说搜搜换源功能使用详解【必学】
    在小说搜搜找不到想看的小说怎么办?小说搜搜换源功能使用详解【必学】

    小说搜搜搜索不到结果?五种实用解决方法帮你搞定 在小说搜搜里搜不到想看的书?这事儿其实挺常见。问题多半出在书源上——要么是默认的书源还没来得及收录,要么是原先的源数据失效了,更新没跟上。别急,下面这五条解决路径,基本能覆盖绝大多数情况,操作起来也不复杂。 一、通过阅读页调出换源入口手动切换 这个方法

    怎么看B站UP主直播的真实人数?在线观看人数换算教程
    怎么看B站UP主直播的真实人数?在线观看人数换算教程

    “实时人气”不等于真实在线人数,需通过区分标识、验证列表与弹幕、第三方工具比对及互动加权扣除四步估算 当你点开B站的某个直播间,屏幕上那个“实时人气:12.8万”的数字可能让你心头一震,觉得场面火热。然而细看之下,弹幕寥寥无几,互动屈指可数——这场景是不是有点眼熟?问题来了:那个醒目的“人气值”,真

    chrome搜索免验证入口
    chrome搜索免验证入口

    Chrome官方免验证入口为https://www.google.cn/chrome/,提供全平台安装包、免登录即用、本地化安全机制及引擎级性能优化。 到底该去哪里找正版、免费且无需繁琐验证的Chrome浏览器入口?这个问题困扰了不少网友。今天,我们就来直通核心,为大家详细拆解Chrome引擎的官方

    Mac导入Android项目指南
    Mac导入Android项目指南

    网上关于在mac上导入现有项目的android studio操作教程多种多样,以下是我在实际操作中成功导入项目所采用的具体步骤及关键注意事项,供各位开发者参考。 网上的教程确实五花八门,但核心流程其实万变不离其宗。根据多年经验,想要在Mac上把已有的Android项目顺利导入Android Stud

    过程式编程、面向对象编程、函数式编程、泛型编程、元编程
    过程式编程、面向对象编程、函数式编程、泛型编程、元编程

    命令式编程关注执行步骤,声明式描述目标,函数式强调无副作用。回调函数作为参数传递,可导致回调地狱,后由Promise解决。仿函数重载`operator()`,lambda更轻量。元编程生成代码,如模板、装饰器、宏,提升抽象能力。

    如何配置Python项目的.gitignore文件_排除环境相关冗余文件
    如何配置Python项目的.gitignore文件_排除环境相关冗余文件

    Python项目配置.gitignore应排除__pycache__、虚拟环境(venv/.venv等)、IDE生成文件(.idea/.vscode等)及缓存目录。误提交后需用`gitrm--cached`移除索引。建议复用GitHub官方模板并验证规则有效性。

    怎么在VSCode中查看Git冲突记录-图形化合并分支操作实操
    怎么在VSCode中查看Git冲突记录-图形化合并分支操作实操

    VSCode不保存历史冲突记录,仅在合并时实时标记冲突文件。冲突文件位于源代码管理面板的MERGECHANGES分组,带红色感叹号和冲突数量。点击文件以三栏合并编辑器显示当前分支、传入分支和结果区,供用户编辑解决冲突。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。