Windows下将gpg-agent配置为Git Bash的SSH代理的问题

老兄，我太懂你这困扰了——之前我也在Windows的Git Bash里折腾了好久才把gpg-agent配置成ssh-agent的替代，而且完全不用碰PuTTY，完美适配现有依赖Git Bash和OpenSSH的脚本、工具（比如PHPStorm这类IDE）。下面是我亲测有效的完整步骤，跟着来绝对能搞定：

1. 修改gpg-agent配置文件 #

首先找到你的gpg配置目录，在Git Bash里输入cd ~/.gnupg就能进入（对应Windows里的C:\Users\你的用户名\.gnupg）。如果没有gpg-agent.conf文件，直接新建一个。

在文件里添加以下配置项：

enable-ssh-support
enable-putty-support
default-cache-ttl 604800
max-cache-ttl 604800

*解释一下：*前两行就是开启你需要的SSH和PuTTY支持（虽然你不用PuTTY，但开启不影响现有配置）；后面两行设置密钥缓存时间为一周（604800秒），避免频繁输入私钥密码，你可以按需调整时长。

2. 配置Git Bash环境变量，让OpenSSH指向gpg-agent #

接下来要让Git Bash启动时自动加载gpg-agent，并让系统的SSH工具默认使用它。编辑你的~/.bashrc文件（没有的话就新建），添加这段脚本：

# 自动启动gpg-agent并绑定SSH套接字
if ! pgrep -x "gpg-agent" > /dev/null; then
  gpg-connect-agent /bye > /dev/null 2>&1
fi
export SSH_AUTH_SOCK=$(gpgconf --list-dirs agent-ssh-socket)

这段代码的作用是：检查gpg-agent是否在运行，没运行就启动它；然后把SSH_AUTH_SOCK环境变量指向gpg-agent的SSH套接字，这样OpenSSH就会用gpg-agent管理密钥，而不是默认的ssh-agent。

3. 导入现有SSH私钥到gpg-agent #

现在把你正在用的SSH私钥导入gpg-agent，运行命令：

ssh-add ~/.ssh/你的私钥文件名（比如id_rsa）

第一次运行会提示你输入私钥密码，输入后密钥就会被缓存起来，之后一周内（按之前的配置）不用再输密码。

4. 验证配置是否生效 #

关闭当前Git Bash窗口，重新打开一个新窗口，依次运行以下命令验证：

• 检查环境变量：echo $SSH_AUTH_SOCK
  应该输出类似/c/Users/你的用户名/AppData/Roaming/gnupg/S.gpg-agent.ssh的路径，说明套接字绑定成功。
• 查看已加载的密钥：ssh-add -l
  如果能看到你导入的密钥列表，就说明gpg-agent已经成功接管SSH密钥管理了。

额外注意事项 #

• 如果之前启动过默认的ssh-agent，记得杀掉进程避免冲突：pkill ssh-agent
• 确保你的Git Bash是最新版本，旧版本可能对gpg-agent的支持有兼容性问题
• 如果遇到gpg-agent启动失败，可以手动运行gpg-agent --daemon启动，然后查看~/.gnupg/gpg-agent.log日志排查错误

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