Mac下VSCode集成终端配置export GPG_TTY=$(tty)后Git签名失效问题

根本原因 #

1. GPG_TTY变量是终端会话启动时一次性赋值的，当VSCode集成终端出现标签页复用、窗格拆分、会话长时间后台挂起时，当前使用的TTY设备路径会发生变化，旧的GPG_TTY值就会失效
2. 如果通过VSCode UI的提交按钮触发操作，而非直接在集成终端输入git命令，git进程不会继承集成终端加载的.zshrc环境变量，导致GPG_TTY未赋值
3. 之前使用GPG Suite临时生效，本质是GPG Suite默认安装了图形化的pinentry程序，不需要依赖TTY读取密码，直接绕过了TTY校验的问题，没有解决根本的变量失效问题

解决方案 #

方案1：自动刷新GPG_TTY变量（适配终端内提交场景） #

将你原来.zshrc里的export GPG_TTY=$(tty)替换为以下配置，每次终端提示符刷新前都会自动更新GPG_TTY为当前会话的最新TTY路径：

precmd() {
  export GPG_TTY=$(tty)
}

如果你的.zshrc里已经存在其他precmd逻辑，把export GPG_TTY=$(tty)追加到现有precmd函数内即可。配置完成后执行source ~/.zshrc生效。

方案2：配置图形化pinentry（全场景适配，永久解决） #

直接配置gpg-agent使用图形化密码输入工具，完全脱离对TTY的依赖，不管是终端提交还是VSCode UI提交都不会触发报错：

1. 先确认pinentry-mac的安装路径，执行which pinentry-mac查询，M系列Mac默认路径为/opt/homebrew/bin/pinentry-mac，Intel系列Mac默认路径为/usr/local/bin/pinentry-mac
2. 编辑~/.gnupg/gpg-agent.conf文件，添加以下内容（路径替换为上一步查询到的实际路径）：

pinentry-program /opt/homebrew/bin/pinentry-mac

3. 执行gpgconf --kill gpg-agent重启gpg代理，配置立即生效。

方案3：适配非交互式会话的环境变量配置 #

如果需要覆盖所有zsh会话（包括VSCode后台触发的非交互式会话），可以在~/.zshenv文件中添加以下配置，只有当存在可用TTY时才会赋值GPG_TTY，不会触发非交互式环境的报错：

if command -v tty >/dev/null && tty -s; then
  export GPG_TTY=$(tty)
fi

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