Ubuntu Wayland环境下恢复Git GPG签名的GUI密码弹窗

我完全理解你现在的困扰——原本Git GPG签名时的GUI密码弹窗突然变成了CLI输入，连VSCode都报错找不到/dev/tty。结合你用的Ubuntu 24.04 + KDE Plasma Wayland环境，我整理了几个针对性的排查和修复步骤，你可以逐一尝试：

1. 修复GPG Agent配置文件的冲突问题 #

你之前的~/.gnupg/gpg-agent.config里重复设置了多个pinentry-program，这会导致GPG Agent无法确定用哪个弹窗程序。咱们先把配置简化，针对KDE Plasma Wayland，优先选择适配Qt的pinentry-qt：

• 打开~/.gnupg/gpg-agent.config，清空原有内容，只保留：

  default-cache-ttl 600
  pinentry-program /usr/bin/pinentry-qt
  

• 保存后，一定要重启GPG Agent让配置生效：

  gpgconf --kill gpg-agent
  

• 可以先测试GPG本身的弹窗：执行echo "test" | gpg --clearsign，看是否弹出GUI密码窗口。

2. 配置Wayland专属的环境变量 #

Wayland会话下，GPG Agent需要额外的环境变量来识别桌面环境，咱们把这些加到~/.profile里（这样每次登录都会生效）：

• 打开~/.profile，添加以下内容：

  if [ "$XDG_SESSION_TYPE" = "wayland" ]; then
    export GPG_TTY=$(tty)
    export PINENTRY_USER_DATA="USE_CURSES=0"
  fi
  

  这里的PINENTRY_USER_DATA是强制pinentry使用GUI而非CLI，对Wayland环境至关重要。
• 添加完成后，注销再重新登录，让环境变量完全生效。

3. 调整pinentry的默认程序优先级 #

你当前默认的pinentry-gnome3在KDE Wayland下适配性不佳，咱们手动把默认程序换成pinentry-qt：

• 执行以下命令：

  sudo update-alternatives --set pinentry /usr/bin/pinentry-qt
  

• 再次重启GPG Agent：

  gpgconf --kill gpg-agent
  

4. 检查Git配置文件的权限和正确性 #

你用了自定义的GIT_CONFIG_GLOBAL=/home/user/.gitconfig_company，要确保这个文件的所有者是你自己，而不是root（毕竟同事之前用root操作过）：

• 查看文件权限：

  ls -l /home/user/.gitconfig_company
  

• 如果所有者是root，执行以下命令修改（把user换成你的实际用户名）：

  sudo chown user:user /home/user/.gitconfig_company
  

• 同时确认Git的GPG配置没有被覆盖：

  git config --global commit.gpgsign
  git config --global user.signingKey
  

  输出应该分别是true和你的签名密钥ID，符合预期即可。

5. VSCode的特殊适配 #

Wayland下VSCode如果用的是原生Wayland版本，可能需要从终端启动才能继承正确的环境变量：

• 关闭所有VSCode窗口，从终端执行code启动VSCode，再尝试签名操作，看是否还报错。
• 如果还是不行，可以在VSCode设置里搜索git.gpgPath，确保指向正确的GPG路径（一般是/usr/bin/gpg）。

最后测试 #

先单独测试GPG的弹窗功能：echo "test" | gpg --clearsign，确认GUI弹窗正常后，再测试Git签名：git commit -S -s -m "test gui prompt"，应该就能看到熟悉的GUI密码窗口了。

内容来源于stack exchange