You need to enable JavaScript to run this app. Mac平台Git签名提交时GPG口令缓存不生效的排查
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 23:45:07