Git提交报错：gpg.format不支持ssh值（Git 2.30.2）

核心问题：Git版本不支持SSH签名格式 #

你的Git版本是2.30.2，**gpg.format = ssh**这个配置是Git 2.34.0才正式引入的功能，旧版本无法识别该参数，因此触发报错。

.gitconfig里的其他问题 #

• 配置项[credentia]拼写错误，应改为[credential]，否则凭证助手功能无法正常生效。

解决路径 #

方案1：升级Git到2.34.0及以上版本 #

这是最直接的解决方式，升级后Git原生支持SSH签名，修正拼写错误后的现有配置即可正常使用。

方案2：不升级Git，通过第三方工具实现SSH签名 #

如果无法升级Git，可借助ssh-keygen配合Git配置实现签名：

1. 删除.gitconfig中的[gpg]配置段
2. 执行以下命令配置SSH签名：

git config --global commit.gpgsign true
git config --global gpg.program ssh-keygen

3. 确保你的SSH密钥已添加到SSH代理，且远程仓库信任该密钥的公钥。

修正后的.gitconfig示例 #

[user]
        email = <my email>
        name = <my name>
        signingkey = /home/<user>/.ssh/id_...

[credential]
        helper = store --file /home/<user>/.my-credentials

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