根本原因是Git未指定签名密钥或GPG agent未正确连接，需通过gpg --list-secret-keys确认密钥、code命令启动VSCode继承环境变量、git config commit.gpgsign true启用签名，并配置gpg-agent缓存密码。
Git 本地 GPG 密钥没配好，VSCode 提交时直接报错 gpg failed to sign the data
根本原因是 Git 不知道该用哪个密钥签名，或 GPG agent 没正确连接。VSCode 本身不管理 GPG，它完全依赖系统级 Git 配置。先确认你已有可用的 GPG 密钥：
- 终端运行
gpg --list-secret-keys --keyid-format LONG，看到类似sec rsa4096/ABC1234567890DEF 2023-01-01才算有密钥 - 如果没有，用
gpg --full-generate-key生成（选 RSA，4096 位，邮箱填 GitHub/GitLab 绑定的） - 生成后务必运行
gpg --armor --export ABC1234567890DEF，把公钥贴到 GitHub/GitLab 的 SSH/GPG keys 设置页
VSCode 提交失败，但终端 git commit -S 成功？检查 VSCode 启动方式
VSCode 图形界面启动时，可能无法继承终端的环境变量（尤其是 GPG_TTY 和 SSH_AUTH_SOCK），导致找不到 GPG agent。这不是 VSCode 设置问题，是启动入口问题：
- 别用桌面图标或 Spotlight 直接打开 VSCode —— 先在终端执行
code启动，这样它能继承当前 shell 的环境 - macOS 用户：如果用 Dock 启动，终端运行
killall Code; code强制重载环境 - Windows 用户：确保 VSCode 是从已配置好
gpgconf --launch gpg-agent的终端（如 Git Bash）中启动的 - Linux 用户：检查桌面环境是否加载了
gpg-agent，可加export GPG_TTY=$(tty)到~/.bashrc或~/.zshrc
VSCode 中提交仍跳过签名？确认 Git 配置里 commit.gpgsign 是 true 且作用域正确
VSCode 调用的是全局或仓库级 Git 配置，不是 VSCode 自己的设置。必须手动设好 Git 的签名开关：
- 对单个仓库生效（推荐）：
git config commit.gpgsign true - 对当前用户所有仓库生效：
git config --global commit.gpgsign true - 同时指定签名密钥 ID（避免多密钥冲突）：
git config user.signingkey ABC1234567890DEF - 别信 VSCode 设置里的 “Git: Enable Gpg Signature” 开关 —— 它只是 UI 提示，不写入 Git 配置，无效
每次提交都弹密码框太烦？让 gpg-agent 缓存密码
默认 GPG agent 只缓存 10 分钟，且 macOS/Linux 下可能未启用 pinentry。关键不是改 VSCode，而是调 GPG 自身行为：
- 编辑
~/.gnupg/gpg-agent.conf，加入三行：
default-cache-ttl 3600 max-cache-ttl 7200 pinentry-program /usr/bin/pinentry-mac
brew install pinentry-mac；Linux 用户一般用 pinentry-gnome3 或 pinentry-tty
gpgconf --kill gpg-agent && gpgconf --launch gpg-agent
真正卡住人的地方，往往不是 VSCode 设置，而是 GPG agent 和 shell 环境的衔接断了——尤其当你切了终端、换了 Shell、或者用了 zsh + oh-my-zsh 这类插件管理器时，GPG_TTY 很容易丢。每次怀疑配置失效，先在 VSCode 内置终端里跑一遍 git commit -S -m "test"，看报错是不是和外部终端一致，就能快速定位是 Git 层还是环境层的问题。
