GitHub GPG密钥在PyCharm中失效但Mac终端可正常使用的排查求助

核心原因 #

PyCharm终端的环境变量PATH和系统终端不一致，导致找不到gpg的可执行文件路径。系统终端会加载你的shell配置文件（比如.zshrc/.bash_profile），但PyCharm终端可能未完全继承这些配置。

排查步骤 #

1. 获取gpg的实际路径
   在系统终端执行：

   which gpg
   

   会得到类似/usr/local/bin/gpg（Intel Mac）或/opt/homebrew/bin/gpg（M系列Mac）的路径。

2. 对比PATH差异
   在PyCharm终端执行：

   echo $PATH
   

   检查刚才拿到的gpg路径是否在输出结果里。如果没有，就是PATH缺失导致的问题。

解决方法 #

临时修复（仅当前PyCharm终端有效）

直接把gpg路径加到PyCharm终端的PATH中：

export PATH="/你的gpg路径:$PATH"

例如你的gpg路径是/opt/homebrew/bin/gpg，就执行：

export PATH="/opt/homebrew/bin:$PATH"

之后再尝试git commit -m "test gpg key"即可正常签名。

永久修复

1. 完善shell配置文件
   如果你用zsh，编辑~/.zshrc；用bash则编辑~/.bash_profile或~/.profile，加入以下内容（替换成你的gpg路径）：

   export PATH="/opt/homebrew/bin:$PATH"
   

   保存后在系统终端执行source ~/.zshrc（对应你的配置文件）使修改生效。

2. 让PyCharm终端继承系统环境
   打开PyCharm的「偏好设置」→「Tools」→「Terminal」：

   • 将「Shell path」设置为你系统使用的shell，比如/bin/zsh或/bin/bash；
   • 勾选「Run command login shell」选项，确保PyCharm终端加载你的shell配置文件，继承完整的PATH。

3. 确认git的gpg程序配置
   在PyCharm终端执行：

   git config --global gpg.program
   

   如果输出为空或路径错误，手动设置正确的gpg路径：

   git config --global gpg.program /opt/homebrew/bin/gpg
   

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