TortoiseGit与GitHub的SSH密钥转换：从RSA到PPK的完整指南

1. 为什么你的TortoiseGit连不上GitHub？一个密钥格式的“小误会”

很多刚开始用TortoiseGit（就是那只可爱的小乌龟）的朋友，在配置GitHub时都踩过同一个坑：明明已经在Git Bash里用 ssh-keygen 命令生成了RSA密钥，也把公钥 id_rsa.pub 的内容老老实实贴到了GitHub的SSH设置里，可一到小乌龟这里，无论是拉取代码还是推送提交，它就是不认账，要么弹窗让你输密码，要么直接报错。折腾半天，你可能会怀疑人生：是不是我安装姿势不对？

别急，这真不是你的问题。问题的根源在于一个“格式不兼容”的小误会。你可以把SSH密钥想象成一把开门的钥匙。GitHub、GitLab这些代码托管平台，它们认的是标准的OpenSSH格式的钥匙，也就是你用 ssh-keygen 命令生成的那种，文件通常是 id_rsa（私钥）和 id_rsa.pub（公钥）。而TortoiseGit呢，它其实是一个“套壳”工具，它的底层用的是另一个非常著名的SSH工具——PuTTY。PuTTY有自己的一套钥匙格式，它的私钥文件扩展名是 .ppk。

所以，情况就变成了：你手里有一把标准的OpenSSH钥匙（RSA格式），能打开GitHub的大门，但TortoiseGit（PuTTY）的锁芯只认它自家的PPK格式钥匙。直接拿RSA钥匙去捅，当然打不开。这就像你拿着A小区的门禁卡，想去刷开B小区的大门，系统不认。解决的办法不是换锁，而是找个“钥匙复制机”，把你手上这把标准的钥匙，复制、转换成B小区锁芯能识别的格式。

这个“钥匙复制机”，就是TortoiseGit自带的 PuTTYgen 工具。我们接下来要做的所有事情，核心就是围绕它展开：要么直接用 PuTTYgen 生成一把GitHub和TortoiseGit都认的新钥匙（RSA公钥 + PPK私钥），要么把你已有的RSA私钥“转码”成PPK格式。我个人的经验是，如果你已经在Git Bash里生成了密钥并且用得很顺手，那么转换现有密钥是最高效的方式，可以避免管理多套密钥的麻烦。但如果你是全新配置，直接从 PuTTYgen 生成也未尝不可。

2. 从零开始：生成一套两全其美的密钥对

如果你还没有生成过任何SSH密钥，或者想为TortoiseGit专门创建一套新的，那么这个方法最直接。整个过程就像在 PuTTYgen 这个“钥匙工厂”里定制一把双头钥匙。

2.1 启动“钥匙工厂”：PuTTYgen

首先，在你的Windows电脑上找到TortoiseGit的安装目录。最方便的方式是点击屏幕左下角的“开始”菜单，在所有程序列表里找到 TortoiseGit 文件夹，点开它，你就能看到 PuTTYgen 这个程序。点击运行它。

程序打开后，你会看到一个简洁的界面。在 Parameters（参数）区域，确保 Type of key to generate（生成的密钥类型）选择的是 RSA。在它旁边，你会看到一个 Number of bits in a generated key（生成密钥的位数）的输入框。这里我强烈建议你将其从默认的2048改为 4096。为什么？因为更长的密钥意味着更高的安全性，虽然对于日常使用2048位目前也足够安全，但既然GitHub等平台现在都推荐使用4096位，我们一步到位更好。设置好后，点击那个大大的 Generate 按钮。

接下来，你会看到一个提示：“Please generate some randomness by moving the mouse over the blank area.”（请通过在空白区域移动鼠标来生成一些随机数）。这不是在开玩笑，也不是程序卡了。密钥生成需要足够的随机性（熵）来保证其不可预测性，移动鼠标就是在帮助程序收集这些随机数据。所以，请随意地在那个空白区域里画圈、乱晃，直到下方的绿色进度条走满。这个过程通常只需要几秒钟。

2.2 复制“门牌号”：获取并配置公钥

进度条走满后，PuTTYgen 会立即生成你的密钥对。界面上半部分那个巨大的文本框里，显示的就是你的 公钥。它的内容以 ssh-rsa AAAAB3Nza... 开头，后面跟着一长串看似乱码的字符，最后是你的邮箱注释。请用鼠标全选这个文本框里的所有内容（Ctrl+A），然后复制（Ctrl+C）。这个公钥，就是你要交给GitHub的“门牌号”。

现在，打开你的浏览器，登录到GitHub。点击右上角的头像，选择 Settings（设置）。在左侧边栏中找到 SSH and GPG keys（SSH和GPG密钥），点击进入。然后点击绿色的 New SSH key（新建SSH密钥）按钮。

在添加页面中，Title（标题）字段可以随意填写，比如“My Work Laptop”或者“Home Desktop”，目的是帮你区分不同设备。最关键的一步来了：将刚才复制的整个公钥内容，原封不动地粘贴到 Key（密钥）那个大文本框里。注意，不要多一个空格，也不要少一个换行。确认无误后，点击 Add SSH key（添加SSH密钥）按钮。这样，GitHub那边就登记好了你的“门牌号”。

2.3 保管好“实体钥匙”：保存PPK格式私钥

公钥交给GitHub后，我们回到 PuTTYgen 窗口。现在需要保存最重要的东西——私钥。点击窗口下方的 Save private key（保存私钥）按钮。

这时，程序可能会弹出一个警告，提示你“是否保存不带密码保护的密钥？”。为了绝对的操作便利性（比如自动化脚本），你可以选择“是”直接保存。但出于安全考虑，我强烈建议你为私钥设置一个密码（Passphrase）。在 Key passphrase 和 Confirm passphrase 框中输入相同的、足够复杂的密码。这样即使私钥文件不慎泄露，没有密码也无法使用。设置好密码后，再点击 Save private key。

在弹出的保存对话框中，选择一个你容易记住且安全的位置（比如 C:\Users\你的用户名\.ssh\ 目录），给文件起个名字，例如 github_rsa.ppk。务必注意，文件扩展名必须是 .ppk。保存好后，你就可以关闭 PuTTYgen 窗口了。这把 .ppk 文件，就是专属于TortoiseGit的“实体钥匙”。

3. 化繁为简：将现有RSA密钥转换为PPK格式

如果你跟我一样，早就用Git Bash生成了RSA密钥，并且已经在多个地方（比如WSL、VS Code的终端）愉快地使用了，那么完全没必要重新生成一套。我们只需要做一个简单的格式转换，让现有的钥匙也能被TortoiseGit使用。这个方法能保持密钥的统一，管理起来更省心。

3.1 找到你的“旧钥匙”

首先，你需要找到之前用 ssh-keygen 生成的私钥文件。它通常位于你的用户目录下的 .ssh 文件夹里（例如：C:\Users\你的用户名\.ssh\）。在这个文件夹里，找到名为 id_rsa 的文件。注意，是那个没有扩展名的 id_rsa 文件，而不是 id_rsa.pub。id_rsa.pub 是公钥，我们已经把它配置到GitHub上了。

3.2 使用PuTTYgen进行“格式转换”

再次打开 PuTTYgen 工具。这次我们不需要点击 Generate，而是看顶部菜单栏。点击 Conversions（转换）菜单，然后选择 Import key（导入密钥）。

在弹出的文件选择对话框中，导航到你刚才找到的 .ssh 目录，选择 id_rsa 文件并打开。如果这个私钥当初生成时设置了密码，PuTTYgen 会提示你输入密码来解锁它。输入正确的密码后，PuTTYgen 的主界面就会加载这个密钥的信息，包括对应的公钥也会显示在上方的文本框里。

你可以核对一下显示的公钥，是否和你之前添加到GitHub上的那个一致。确认无误后，接下来的步骤就和上一节一样了：点击 Save private key 按钮，将转换后的私钥保存为 .ppk 格式的文件，比如可以命名为 id_rsa.ppk，并把它和原来的 id_rsa 文件放在同一个目录下方便管理。至此，钥匙的转换工作就完成了，简单得超乎想象，对吧？

4. 把钥匙交给“门卫”：在TortoiseGit中加载私钥

现在，我们有了PPK格式的私钥，但TortoiseGit还不会自动使用它。我们需要通过一个叫 Pageant 的程序，把钥匙交给TortoiseGit的“门卫”。Pageant 是PuTTY套件中的认证代理，它的作用就是在后台帮你管理这些PPK私钥，当TortoiseGit需要进行SSH连接时，Pageant 会自动提供对应的私钥，无需你每次手动指定。

4.1 启动并配置Pageant

同样，在开始菜单的 TortoiseGit 文件夹里，找到并运行 Pageant 程序。启动后，你可能在桌面上看不到任何窗口，因为它通常会最小化到系统托盘区（就是屏幕右下角，时钟旁边的那一块）。在那里，你会看到一个戴着牛仔帽的电脑图标，这就是 Pageant。

用鼠标右键点击这个图标，选择 View Keys（查看密钥）。会弹出一个名为“Pageant Key List”的小窗口。目前里面应该是空的。点击窗口下方的 Add Key（添加密钥）按钮。

在弹出的文件选择框中，找到你刚才保存的 .ppk 文件（比如 github_rsa.ppk 或 id_rsa.ppk），选中并打开。如果这个PPK文件在保存时设置了密码，此时会弹窗要求你输入密码。输入正确密码后，你就能在密钥列表里看到新添加的密钥了，通常会显示为密钥的指纹（一串十六进制数字）或你设置的注释。点击 Close 关闭窗口即可。

重要提示：Pageant 加载密钥是“临时性”的。也就是说，一旦你关闭电脑或者退出了 Pageant 程序，下次就需要重新添加。如果你觉得麻烦，可以创建一个快捷方式，让 Pageant 在开机时自动启动并加载指定密钥，这个我们后面会提到。

4.2 为特定仓库配置私钥（可选但推荐）

虽然通过 Pageant 加载密钥后，大多数情况下TortoiseGit就能正常工作了，但为了更精确的控制，特别是当你有多套密钥（比如分别用于公司和个人的GitHub账号）时，我建议为每个Git仓库单独配置一下私钥路径。

在你的项目文件夹里，右键点击空白处，选择 TortoiseGit -> Settings（设置）。在弹出的设置窗口中，左侧选择 Git，然后在右侧面板中找到 Remote（远程）选项。

在 Remote 设置页，你会看到一个 URL 输入框，确保这里填写的是你GitHub仓库的SSH地址（格式如：git@github.com:你的用户名/仓库名.git）。然后，最关键的一步：找到下方的 Putty Key 选择框。点击旁边的浏览按钮（…），直接定位到你保存的 .ppk 私钥文件并选中它。

这样配置的好处是，TortoiseGit在操作这个特定仓库时，会明确使用你指定的这把钥匙，优先级高于 Pageant 中加载的全局钥匙。配置完成后，点击 Apply（应用）再点 OK（确定）。

5. 验证与排错：确保一切就绪

配置完成后，让我们进行一次快速的“点火测试”，确保所有环节都已打通。

5.1 执行一次拉取操作

在你的项目文件夹里，再次右键，选择 TortoiseGit -> Pull（拉取）。在弹出的拉取窗口中，确保分支是正确的，然后直接点击 OK。

如果一切配置正确，你会看到命令行窗口快速闪过，然后拉取操作成功完成，没有任何密码提示弹窗。这标志着你的SSH密钥转换与配置大功告成！从此以后，你可以享受TortoiseGit带来的可视化操作便利，同时拥有SSH协议的安全与高效。

5.2 遇到问题？先检查这几点

如果拉取失败了，或者仍然提示需要密码，别慌，我们可以按照以下顺序排查：

1. 公钥是否粘贴正确？ 这是最常见的问题。请再次登录GitHub的SSH keys设置页面，检查你添加的公钥。确保开头是 ssh-rsa，结尾是你的邮箱，中间没有多余的空格或换行。最稳妥的办法是，用 PuTTYgen 重新打开你的PPK文件，复制上方的公钥，然后去GitHub上删掉旧的，粘贴这个新的进去。
2. Pageant是否加载了正确的私钥？ 双击系统托盘的Pageant图标，查看密钥列表。确认里面有你刚刚添加的密钥。如果没有，重新添加一次。
3. 仓库Remote配置的URL对吗？ 在仓库的TortoiseGit设置里，检查Remote的URL。必须是SSH格式（git@github.com:...），而不能是HTTPS格式（https://github.com/...）。这是两个完全不同的认证协议。
4. 私钥文件路径是否有效？ 如果你在仓库设置里指定了Putty Key路径，请检查这个路径下的 .ppk 文件是否存在，并且TortoiseGit进程有权限读取它。
5. 防火墙或网络代理干扰？ 极少数情况下，公司的网络策略或防火墙可能会干扰SSH的22端口。可以尝试在Git Bash里用命令 ssh -T git@github.com 测试连通性。如果这里能成功返回“You've successfully authenticated...”，那问题就出在TortoiseGit配置上；如果这里也失败，那就是系统或网络层面的问题了。

6. 高效工作流：让配置一劳永逸

每次开机都要手动打开Pageant加载密钥太麻烦了。这里分享两个我用了很多年的小技巧，能让你的开发环境更加顺滑。

技巧一：让Pageant开机自启并自动加载密钥。 创建一个文本文件，将其后缀改为 .bat，比如叫 start_pageant.bat。用记事本打开，写入以下内容：

start "" "C:\Program Files\TortoiseGit\bin\pageant.exe" "C:\Users\你的用户名\.ssh\id_rsa.ppk"

请根据你的实际安装路径和PPK文件路径修改上面的引号内的内容。然后，将这个 .bat 文件的快捷方式放到系统的“启动”文件夹（可以通过运行 shell:startup 打开）。这样每次开机，Pageant就会自动启动并加载你的密钥。

技巧二：管理多个Git账户的密钥。 如果你有工作和个人两个GitHub账号，需要两套不同的密钥。你可以在 Pageant 里同时加载多个 .ppk 文件。关键在于仓库的配置：为工作仓库的Remote设置指向工作账号的PPK路径，为个人仓库设置指向个人账号的PPK路径。TortoiseGit在连接时，会优先使用仓库配置里指定的密钥，如果没指定，才会尝试使用Pageant里加载的密钥。通过这种“全局加载+局部指定”的方式，可以优雅地解决多账号问题。

最后，关于密钥安全再多说一句。那个 .ppk 私钥文件是你的数字身份凭证，务必妥善保管。不要把它上传到任何网盘、代码仓库或通过不安全的渠道发送。定期备份 .ssh 目录是个好习惯，但备份文件也要加密存储。如果你是在公用电脑上操作，使用完毕后记得从Pageant中移除密钥并关闭程序。掌握了从RSA到PPK的转换，你就打通了TortoiseGit与GitHub协同工作的任督二脉。这套方法同样适用于GitLab、Gitee等任何支持SSH的Git托管平台，原理都是相通的。