Git 提交签名 verification failed 怎么配置 GPG 密钥-三亩地-编程学习日记

遇到 Git 提交签名 verification failed，通常是本地 Git 未配置正确的 GPG 密钥 ID，或者远程仓库缺少对应的公钥。优先检查本地密钥配置并同步公钥到代码托管平台。

先说结论：签名验证失败本质是信任链断裂，需确保本地私钥可用且远程平台信任对应的公钥。

先确认：检查本地 GPG 密钥列表及关联邮箱
先处理：将密钥 ID 写入 Git 配置并导出公钥
再验证：在远程仓库设置中添加公钥并查看提交状态

命令速用版

如果你需要快速恢复签名功能，可按顺序执行以下命令。注意将 <KEY_ID> 替换为你实际的密钥 ID。

# 1. 查看本地密钥 ID
gpg `--list-secret-keys` `--keyid-format` LONG# 2. 配置 Git 使用该密钥
git config `--global` user.signingkey <KEY_ID># 3. 开启提交自动签名（可选）
git config `--global` commit.gpgsign true# 4. 导出公钥用于上传
gpg `--armor` `--export` <KEY_ID>

新手指南：如何生成 GPG 密钥

如果本地没有密钥，需要先生成。执行以下命令进入交互式生成流程：

gpg `--full-generate-key`

按提示操作：

密钥类型：默认 RSA and RSA (1)
密钥长度：建议 4096
有效期：建议设置过期时间（如 1y），后续可续期
姓名和邮箱：必须与 Git 配置的 user.name 和 user.email 一致

为什么会这样

Git 的签名机制基于非对称加密。你在本地使用私钥对提交内容生成签名，而远程平台（如 GitHub、GitLab）或协作方的 Git 客户端使用公钥来验证这个签名是否合法。

出现 verification failed 通常有三种情况：一是本地 Git 不知道用哪个密钥签名；二是签名用的密钥与提交者邮箱不匹配；三是验证方没有导入你的公钥，无法建立信任。这不代表代码内容被篡改，只是身份无法被 cryptographic 确认。

分步处理

按照以下步骤排查和配置，确保每一步都有明确反馈。

1. 确认本地密钥状态

执行 gpg `--list-secret-keys` `--keyid-format` LONG。如果没有输出，说明本地没有可用私钥，需要先生成。如果有输出，记下 sec 行后面的密钥 ID（通常是 40 位字符或 16 位 hex）。

2. 配置 Git 关联密钥

告诉 Git 使用哪个密钥进行签名。执行：

git config `--global` user.signingkey <KEY_ID>

同时检查 Git 的用户邮箱是否与 GPG 密钥中的邮箱一致：

git config `--global` user.email
gpg `--list-keys`

如果不一致，签名验证会失败，需修改 Git 邮箱或重新生成带正确邮箱的 GPG 密钥。

3. 上传公钥到远程平台

执行 gpg `--armor` `--export` <KEY_ID>，复制输出的内容（包含 ---`--BEGIN` PGP PUBLIC KEY BLOCK-----）。登录代码托管平台，在设置中找到 SSH and GPG keys 或类似选项，添加新的 GPG key。

4. 重新提交

配置完成后，对新的提交执行 git commit -S -m "message"。如果已开启自动签名，直接 commit 即可。

密钥有效期管理实操

GPG 密钥可以设置有效期。如果密钥过期，签名会失效。

查看有效期：

gpg `--list-keys`

延长有效期：

gpg `--edit-key` <KEY_ID>

进入交互界面后，输入 expire，设置新的过期时间，最后输入 save 保存。

怎么验证是否生效

本地验证：执行 git log `--show-signature`。如果看到 gpg: Good signature from ...，说明本地签名正常。

远程验证：刷新远程仓库的提交列表页面。正常的签名提交会显示 Verified 标签或绿色对勾图标。如果仍显示 Unverified，检查公钥是否复制完整，或是否有多个密钥冲突。

常见坑

1. 子密钥问题

部分用户习惯使用子密钥签名。配置 Git 时请使用实际用于签名的子密钥 ID，而不是主密钥 ID。

2. 多密钥环境

如果本地有多个密钥，Git 可能默认使用了错误的那个。务必在 git config 中显式指定 user.signingkey。

3. 换行符干扰

复制公钥到网页平台时，确保没有多余的空行或缺失的头部尾部标识，否则平台无法解析。

参考来源

Git Documentation: git-config - https://git-scm.com/docs/git-config
GitHub Docs: About commit signature verification - https://docs.github.com/en/authentication/managing-commit-signature-verification/about-commit-signature-verification
GnuPG Documentation: How to generate a new key pair - https://www.gnupg.org/documentation/howtos.html

原文链接：https://www.zjcp.cc/ask/11131.html

日记详情

Git 提交签名 verification failed 怎么配置 GPG 密钥