如何配置IntelliJ IDEA提交侧边栏实现Git GPG自动签名？

问题说明 #

终端执行git commit -S可正常完成GPG签名提交，但在IntelliJ IDEA提交侧边栏提交代码时，必须先手动执行echo "test" | gpg --clearsign才能触发GPG签名流程。需实现无需额外命令，直接通过IDEA提交侧边栏完成带GPG签名的提交。

本地环境 #

• MacOS 15.5
• git version 2.49.0
• gpg (GnuPG) 2.4.8
• IntelliJ IDEA 2024.1.7（旗舰版）

已配置内容 #

Git配置 #

commit.gpgsign=true
gpg.program=gpg
gpg.extraargs=--pinentry-mode=loopback

单独提交签名设置：

commit.gpgsign=true

gpg-agent配置（~/.gnupg/gpg-agent.conf） #

allow-loopback-pinentry

解决方案 #

1. 确保IDEA正确读取Git配置 #

• 打开IDEA设置（Mac：IntelliJ IDEA > Settings；Windows/Linux：File > Settings）
• 导航至Version Control > Git
• 确认Path to Git executable指向系统正确的Git路径（Mac通常为/usr/bin/git），点击Test验证连接正常
• 勾选Use credential helper，确保IDEA复用系统Git凭证配置

2. 开启IDEA内置GPG签名选项 #

• 在设置中导航至Version Control > Commit
• 勾选Sign commits with GPG key
• 点击Configure GPG Keys，选择用于签名的GPG密钥（未自动识别的话，点击Import手动导入本地密钥）
• 确保GPG program设置为gpg，与Git配置保持一致

3. 修复MacOS环境变量问题 #

MacOS下IDEA可能无法正确获取gpg-agent的环境变量，导致签名流程异常：

• 编辑Shell配置文件（如~/.zshrc或~/.bash_profile），添加：

export GPG_TTY=$(tty)

• 执行source ~/.zshrc（对应你的配置文件）使设置生效
• 重启IntelliJ IDEA，确保环境变量被加载

4. 重置gpg-agent状态 #

• 重启gpg-agent以应用配置：

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

• 终端测试无额外命令的签名是否正常：

echo "test" | git commit -S -m "test sign" --allow-empty

若能直接完成签名，说明Git与GPG的基础配置无问题

5. 切换IDEA终端执行环境 #

• 进入Settings > Tools > Terminal，将Shell path设置为系统默认Shell（如/bin/zsh）
• 重启IDEA后尝试提交代码

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