使用Git时GPG密码界面无法提交密码问题求助

可能的触发原因： #

• TTY绑定未持久生效：手动执行export GPG_TTY=$(tty)仅临时生效，终端重启或切换会话后，GPG代理无法正确关联当前终端TTY，导致输入界面失去交互能力，尤其在VS Code内置终端、分屏终端这类非原生环境中更易出现。
• Pinentry程序异常：GPG依赖的密码输入工具pinentry被替换为不兼容版本，或配置文件损坏。比如系统默认的pinentry-gtk2/pinentry-qt在部分终端环境下，无法正常渲染输入框、响应回车或隐藏输入内容。
• GPG代理冲突或状态异常：多GPG代理实例同时运行，或代理套接字权限出现问题，会导致密码请求无法正确传递到终端输入界面，出现假死状态。
• 终端环境变量异常：终端TERM变量设置错误（如改为不支持的类型），或当前用户无权限访问GPG代理运行目录，也会引发输入界面交互故障。

排查方向： #

1. 换原生终端测试：使用系统自带终端（如Mac的Terminal.app、Linux的GNOME Terminal）执行git pull --rebase，排除第三方终端的兼容性问题。
2. 持久化TTY配置：将export GPG_TTY=$(tty)添加到shell配置文件（~/.bashrc、~/.zshrc等），执行source ~/.zshrc生效后重启终端。
3. 检查并重置Pinentry：
   • 执行gpgconf --list-dirs找到pinentry路径，直接运行该路径下的pinentry测试是否能正常输入密码。
   • 若异常，切换到纯终端版pinentry-tty：执行gpgconf --set gpg-agent pinentry-program /usr/bin/pinentry-tty，随后重启GPG代理。
4. 重启GPG代理：执行gpgconf --kill gpg-agent，再启动代理gpg-agent --daemon，之后重试Git操作。

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