Mac平台Git签名提交时GPG口令缓存不生效的排查
macOS 环境下 GPG 口令缓存不生效修复指南
10分钟就要求重新输入GPG口令的现象,本质是自定义的gpg-agent缓存配置未被正确加载,GnuPG仍在使用默认的600秒(10分钟)缓存时长。按以下步骤逐一修正即可:
- 修正gpg-agent.conf的配置格式
GnuPG配置文件不支持行尾注释,当前配置中每行参数后附加的# 14 days这类行尾说明会被识别为无效参数,导致整行配置解析失败。正确配置需将注释单独成行,不要和参数写在同一行:# 14天默认口令缓存时长 default-cache-ttl 1209600 # 1年最大口令缓存时长 max-cache-ttl 3153600 - 强制重启gpg-agent加载新配置
配置文件修改完成后不会自动热加载,执行以下命令终止当前运行的gpg-agent进程,下次调用时会自动读取新配置启动:gpgconf --kill gpg-agent
执行gpg-connect-agent 'GETINFO cache_info' /bye即可验证当前生效的缓存时长是否和配置一致。 - 匹配Git调用的GnuPG路径
Homebrew安装的GnuPG默认路径为/usr/local/bin/gpg,macOS系统自带的旧版GnuPG路径为/usr/bin/gpg。如果Git未指定调用路径,会默认调用系统自带的旧版程序,无法读取Homebrew版gpg-agent的配置规则。
执行以下命令指定Git使用的GnuPG程序路径:git config --global gpg.program /usr/local/bin/gpg - 修正Git配置的存放位置
将[commit] gpgSign = true的配置写入全局.gitignore文件属于位置错误——.gitignore仅用于声明版本控制的文件忽略规则,Git全局配置需写入~/.gitconfig文件。直接通过命令写入配置可避免手动编辑出错:git config --global commit.gpgsign true - 配置gpg-agent常驻运行
如果gpg-agent是终端会话临时启动的进程,关闭终端后进程会退出,已缓存的口令会被一并清空。通过Homebrew的服务管理能力将gpg-agent设为开机常驻,所有终端会话将复用同一个agent进程,不会随终端关闭丢失缓存:
执行brew services start gpg-agent完成常驻配置。
内容的提问来源于stack exchange,提问作者Paul Razvan Berg
相关产品推荐
相关产品推荐

