在我的情况下，我必须将存储在GitHub设置中的名称与键的名称和注释匹配。

所以如果gpg——list-keys返回uid [ultimate] Joe Blogs(花式注释)<email@example.com>你在.gitconfig中的名字应该是Joe Blogs(花式注释)。

最初，我将自己的名字设置为Joe Blogs, GPG不会找到我的密钥，并在strace中显示“无密钥”错误。不幸的是，如果没有strace，该错误就不会出现，并且会得到泛型

error: gpg failed to sign the data
fatal: failed to write commit object

我正在使用它。它支持zsh和工作在Windows子系统Linux:

export GPG_TTY=$(tty)

其他用户已经确认以上是MacOS(例如Catalina 10.15.7)所需的唯一更改。对于mac，将以上内容添加到~/.zshrc。

在使用WSL2的Windows中的Linux容器中也可以工作。

如果它曾经工作，只是声明失败，杀死代理，再试一次:

gpgconf --kill gpg-agent

检查代理是否再次启动:

echo "test" | gpg --clearsign

对于故障排除，首先要尝试两件事:

运行gpg——version，并确保安装了GnuPG版本2+(而不是版本1) 执行echo "test" | GPG——clearsign命令，确认GPG本身在工作

如果一切看起来都没问题，接下来要尝试的一件事是:

运行brew install pinentry以确保您已经安装了用于密码短语输入的良好工具

如果在安装之后，你再次尝试git提交，仍然得到一个“failed to sign the data”错误，请执行:

执行gpgconf——kill gpg-agent命令杀死任何可能挂起的正在运行的代理

否则，运行一些基本步骤来检查你是否有一个正常工作的GnuPG环境:

执行gpg -K——keyid-format SHORT命令，检查至少有一个密钥对没有过期

如果输出显示你没有供GnuPG使用的密钥，你需要创建一个:

运行gpg——gen-key，让GnuPG引导您完成创建密钥对的步骤

如果你得到一个错误消息说“不合适的ioctl为设备”，这样做:

运行export GPG_TTY=$(tty)和/或将其添加到~/。Bashrc或~ /.bash_profile

你的git以某种方式配置为GPG签署每次提交。使用GPG签名不需要使用git提交或推送。它很可能会给出错误，因为您的gpg签名机制还没有配置。

如果您是git的新手，请尝试在一开始不使用GPG签名的情况下让它工作，然后在确实需要时添加签名。

你可以通过以下方法验证git是如何配置gpg的:

git config -l | grep gpg

它可以产生零或多行，包括:

commit.gpgsign=true

如果“提交。“Gpgsign”为真，则启用了GPG签名。禁用它:

git config --global --unset commit.gpgsign

然后尝试再次运行提交。现在它应该在没有gpg签名的情况下运行。在基本的git工作之后，您应该尝试将gpg签名重新添加到组合中。

使用GIT_TRACE=1查看Git失败的地方，然后检查Git使用的所有自定义配置以及它们定义的地方，然后根据您的需要覆盖:

GIT_TRACE=1 git commit -S -m "this will tell you wich intern git command failed"

git config --list --show-scope --show-origin

对我来说，我有错误:gpg未能签署数据和致命:未能写入提交对象，因为Git默认使用smimesign，即使我取消设置gpg.x509。程序钥匙，smimesign找不到我的钥匙。

所以我必须显式地告诉Git使用gpg:

git config --local gpg.x509.program gpg