无需GNUPGHOME环境变量配置Git提交签名验证的GPG主目录

在Windows 11环境下，Git的gpg.program配置项仅支持指定可执行文件路径，无法直接附加--homedir这类参数，这是你遇到报错的核心原因。除了依赖GNUPGHOME环境变量外，你可以通过编写包装脚本的方式实现精细控制，具体步骤如下：

方法一：使用批处理脚本（推荐） #

1. 创建一个批处理文件（例如命名为gpg-work.bat），内容如下：

@echo off
"C:/Program Files (x86)/GnuPG/bin/gpg.exe" --homedir "C:/Users/U1/.gpg-work-keys" %*

• %*会将Git传递给脚本的所有参数原封不动转发给GPG，确保签名、验证等所有功能正常工作。
• 请根据实际路径调整GPG安装路径和工作密钥目录。

2. 将该批处理文件放置在一个路径不含空格的目录下（例如C:/Users/U1/scripts）。

3. 配置Git使用该脚本作为GPG程序：

git config --local gpg.program "C:/Users/U1/scripts/gpg-work.bat"

4. 验证功能：执行签名提交命令，确认可以正常完成签名：

git commit -m "test signed commit" -s -SA_WORK_HOMEDIR_A_SIGNING_KEY!

方法二：使用PowerShell脚本 #

如果你更倾向于PowerShell，也可以编写对应的脚本：

1. 创建gpg-work.ps1，内容如下：

& "C:/Program Files (x86)/GnuPG/bin/gpg.exe" --homedir "C:/Users/U1/.gpg-work-keys" $args

2. 配置Git调用该脚本（注意需要处理PowerShell的执行策略）：

git config --local gpg.program "powershell.exe -ExecutionPolicy Bypass -File C:/Users/U1/scripts/gpg-work.ps1"

若不使用脚本的情况 #

如果不想通过包装脚本实现，那么确实只能依赖GNUPGHOME环境变量——Git官方并未提供直接配置GPG主目录的内置选项，所谓的gpg.homedir配置项并不存在于Git的官方配置文档中，无法生效。

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