使用Git提交签名时未弹出GPG密钥密码输入框的问题

这问题我之前帮好几个开发者排查过，核心原因就是GPG代理没有正确触发密码输入弹窗，也没缓存密钥密码——Git调用GPG签名时，代理直接返回失败，而你提前运行的那个gpg命令相当于手动触发了密码验证流程，让代理缓存了密码，所以后续签名就能正常走通了。下面给你一套长期有效的解决方案：

一、配置GPG代理与Git的协作 #

1. 调整GPG核心配置 #

打开你的GPG配置文件（路径通常是~/.gnupg/gpg.conf），添加或确保存在以下内容：

use-agent
pinentry-mode loopback

这两行配置让GPG启用代理，并允许通过回环模式调用密码输入工具（Git需要这种模式来触发弹窗）。

2. 配置GPG代理的缓存规则 #

打开~/.gnupg/gpg-agent.conf（如果没有就新建一个），添加：

allow-loopback-pinentry
default-cache-ttl 3600
max-cache-ttl 86400

• allow-loopback-pinentry：允许Git通过回环方式请求密码输入
• default-cache-ttl：设置密码默认缓存1小时（单位：秒）
• max-cache-ttl：最长缓存24小时，避免频繁输入密码

3. 重启GPG代理让配置生效 #

执行以下命令重启代理：

gpgconf --kill gpg-agent
gpg-agent --daemon

4. 让Git关联GPG #

执行以下全局配置，确保Git使用正确的GPG程序并默认签名提交：

git config --global gpg.program gpg
git config --global commit.gpgSign true

如果你的环境用的是GPG2，把命令里的gpg换成gpg2即可。

二、为什么你之前的临时方法有用？ #

你运行的gpg -o /dev/null --local-user MY_KEY_ID -as <(echo 1234)命令，本质是手动发起了一次签名操作，强制GPG代理弹出密码输入框并缓存你的密钥密码。当后续Git调用GPG签名时，代理直接复用缓存的密码，不需要再次弹窗，所以签名成功。但这只是临时 workaround，上面的配置能让Git和GPG长期自动协作。

额外排查点 #

• 确认你的密钥IDMY_KEY_ID正确：用gpg --list-secret-keys --keyid-format=long查看私钥的完整ID
• 检查密码输入工具（pinentry）是否正常：在终端执行pinentry，看是否能弹出密码输入框。图形界面环境下，确保安装了对应工具（比如pinentry-gtk2、pinentry-qt）

内容的提问来源于stack exchange，提问作者Oscar