Git提交记录里的作者信息默认只是纯文本，任何人都可以随意填写。开启GPG签名后，每次提交的身份都会经过密码学加密验证，能有效防止他人冒用你的账号进行代码提交，这也是许多开源项目和正规企业团队的硬性要求。下面按实际开发顺序，把环境准备、密钥生成、配置方法和日常排查全部讲透。
第一步：确认GPG工具已就位
主流Linux发行版和macOS系统通常预装了GPG套件。Windows开发者需要前往官网下载Win32GnuPG或结合Git Bash使用。打开终端执行gpg --version，只要能看到版本号输出，就说明基础环境没问题。若提示命令不存在，请检查安装包是否完整，并将gnupg的安装路径加入系统环境变量PATH。
第二步：生成GPG密钥对
在终端运行gpg --full-generate-key。程序会依次引导你选择加密算法、密钥长度和有效期。日常开发推荐保留默认的RSA算法，长度选默认值即可。过期时间建议设置为一年或两年，避免私钥永久失效引发安全风险。随后输入你的真实姓名和项目常用邮箱，邮箱必须与全局配置的user.email完全一致。最后设定一个复杂度高的密码，该密码会在每次提交时用于解锁私钥。
第三步：导出公钥并绑定代码平台
签名校验依赖公钥。执行gpg --list-secret-keys --keyid-format long查看密钥列表，复制长ID那一行的末尾十六进制串。接着输入gpg --armor --export 密钥ID，将终端打印出的文本完整复制。打开GitHub或GitLab后台，进入Settings页面的SSH and GPG keys，点击New GPG Key按钮，粘贴公钥内容并命名保存。绑定成功后，平台就能自动识别你后续的签名提交。
第四步：让Git自动调用签名密钥
执行git config --global user.signingkey 你的短密钥ID，短ID可从上一步列表最后八位截取。为减少重复操作，继续在终端输入git config --global commit.gpgSign true。这两条命令写入全局配置后，所有常规提交都会自动附加数字签名，无需手动加-S参数。若仅需针对某个独立仓库生效，删除--global参数即可限定作用域。
第五步：解决密码弹窗与代理异常
初次提交时屏幕可能出现空白对话框或命令行等待输入密码，属于gpg-agent的正常响应。若报错提示找不到pinentry程序，说明缺少图形交互辅助组件。Linux用户可通过包管理器安装pinentry-tty或pinentry-gnome3；macOS执行brew install pinentry-mac，并在~/.gnupg/gpg-agent.conf末尾追加pinentry-program /opt/homebrew/bin/pinentry-mac；Windows用户如遇乱码，请在系统环境变量中补充GPG_TTY和TERM=xterm-256color。
第六步：验证签名链路是否通畅
配置完毕后进行一次普通提交。终端输入git log --show-signature查看最新记录，若出现good signature且附带Verified标识，代表签名流程彻底跑通。频繁出现bad signature多半是密钥ID错位或邮箱不匹配，重新核对配置项即可。日常使用中，VS Code的GitLens插件或GitKraken客户端均支持直观展示签名状态，便于快速定位问题。
完成上述步骤后，你的每一次代码贡献都将携带不可篡改的身份凭证。妥善保管私钥密码、定期更新密钥周期，配合平台的双因素认证，能显著提升个人技术履历的可信度。按指引操作一遍即可稳定运行，后续开发照常推进，无需额外干预。
