写在前面
在日常开发工作中，不少开发者会在 Gitee（码云）与 GitHub 两个代码托管平台之间频繁切换。如果你在这两个平台注册时使用的是同一个邮箱地址，那么有个好消息：完全可以共用同一套 SSH 密钥，从而省去重复生成、管理多套密钥的繁琐流程。
本文将以 Windows 系统为基础，逐步讲解如何将已配置好的 Gitee SSH 密钥无缝复用到 GitHub，实现 “一套密钥通行两个平台” 的流畅体验。
适用场景与前置条件
适用人群
- 已在 Windows 上完成 Gitee 的 SSH 连接配置
- 当前需要为 GitHub 配置 SSH 连接
- 两个平台注册时使用了相同的邮箱地址
前置条件
- Windows 10 或 11 操作系统
- 已安装 Git for Windows
- 拥有 Gitee 和 GitHub 账号，且注册邮箱一致
~/.ssh目录下已存在密钥文件，例如id_rsa/id_rsa.pub
第一步：确认现有 SSH 密钥
打开 PowerShell（以普通用户身份运行即可），先查看当前已有的 SSH 密钥情况：
ls ~/.ssh
正常情况下，你至少会看到以下文件：
id_rsa—— 私钥（绝密文件，切勿泄露给他人）id_rsa.pub—— 公钥（可公开，需要上传至托管平台）known_hosts—— 已信任的服务器指纹记录
如果之前已经配置过 Gitee，说明这套密钥已经过验证，可以直接复用，无需重新生成。
第二步：将公钥添加到 GitHub
2.1 复制公钥内容
在 PowerShell 中，使用以下命令将公钥内容复制到剪贴板：
type ~/.ssh/id_rsa.pub | clip
需要特别留意：PowerShell 不支持 Linux/CMD 风格的 < 重定向符，因此不要使用 clip < ~/.ssh/id_rsa.pub。如果 clip 命令无法正常执行，直接用记事本打开 id_rsa.pub 手动复制内容即可。
2.2 在 GitHub 中添加公钥
- 登录 GitHub，点击右上角头像 → Settings
- 左侧菜单选择 SSH and GPG keys
- 点击 New SSH key
- Title 栏填一个便于识别的名称，例如
My-Windows-Laptop - Key 栏粘贴刚才复制的公钥内容（以
ssh-rsa开头） - 点击 Add SSH key 保存
第三步：配置 SSH 客户端（核心步骤）
这是整个配置流程的关键环节。通过编辑 ~/.ssh/config 文件，可以为不同平台指定认证方式，同时为 GitHub 强制使用 443 端口，以穿透防火墙限制。
3.1 创建或编辑 config 文件
在文件资源管理器地址栏输入 %USERPROFILE%.ssh 并回车，进入该目录。
在此目录下新建一个名为 config 的文本文件（注意：没有扩展名）。
3.2 写入以下配置
用记事本打开 config 文件，添加以下内容：
# Gitee 配置（保留原有配置，确保指向正确的私钥）
Host gitee.com
HostName gitee.com
User git
Port 22
IdentityFile ~/.ssh/id_rsa
PreferredAuthentications publickey
# GitHub 配置（新增，使用 443 端口绕过防火墙）
Host github.com
HostName ssh.github.com # GitHub 的 SSH 专用域名
User git
Port 443 # 使用 HTTPS 端口，避免 22 端口被屏蔽
IdentityFile ~/.ssh/id_rsa # 指向与 Gitee 相同的私钥！
PreferredAuthentications publickey
3.3 配置字段说明
| 字段 | 含义 |
|---|---|
Host | 匹配 Git 命令中的主机名 |
HostName | 实际连接的目标主机地址 |
Port | SSH 连接端口（GitHub 推荐使用 443） |
IdentityFile | 指定使用的私钥文件路径 |
PreferredAuthentications | 优先采用的认证方式 |
关键点：GitHub 和 Gitee 的 IdentityFile 都指向同一个私钥文件，这正是“共用密钥”的核心原理。
第四步：验证连通性
在 PowerShell 中分别测试两个平台：
# 测试 Gitee（应该直接成功） ssh -T git@gitee.com # 测试 GitHub（首次连接会提示确认指纹） ssh -T git@github.com
首次连接 GitHub 时的指纹确认
由于配置了 Port 443 和 HostName ssh.github.com，SSH 会将其视为一台新主机，弹出以下提示：
The authenticity of host '[ssh.github.com]:443 ([20.205.243.160]:443)' can't be established. ED25519 key fingerprint is SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU. Are you sure you want to continue connecting (yes/no/[fingerprint])?
直接输入 yes 并回车即可。这是 GitHub 官方的 ED25519 指纹，安全可信，可放心确认。
成功标志
如果看到以下输出，说明配置已成功：
Hi <你的GitHub用户名>! You've successfully authenticated, but GitHub does not provide shell access.
对于 Gitee，成功信息类似：
Hi <你的Gitee用户名>! You've successfully authenticated, but GITEE.COM does not provide shell access.
第五步（可选）：HTTPS 自动转 SSH
为了日常使用更加便捷，可以配置 Git 全局 URL 重写。这样，即使从网页复制了 https:// 开头的仓库地址，Git 也会自动将其转换为 SSH 协议。
执行以下两条命令：
git config --global url."git@github.com:".insteadOf "https://github.com/" git config --global url."git@gitee.com:".insteadOf "https://gitee.com/"
设置后，以下操作会自动转换：
git clone https://github.com/user/repo.git→ 实际使用git@github.com:user/repo.gitgit clone https://gitee.com/user/repo.git→ 实际使用git@gitee.com:user/repo.git
关于“邮箱相同，用户名不同”的说明
平台如何匹配提交记录？
答案是：通过邮箱地址，而不是用户名。
| 字段 | 作用 | 是否用于身份验证 |
|---|---|---|
user.email | 平台通过它关联账号、统计贡献、显示头像 | ✅ 关键字段 |
user.name | 仅作为提交记录的显示标签 | ❌ 不参与验证 |
常见场景示例
- 邮箱：
your_email@example.com（两个平台注册邮箱一致） - GitHub 用户名：
your_github_username - Gitee 用户名：
your_gitee_username - Git 全局
user.name：your_display_name
推送时：
- 向 GitHub 推送 → 邮箱匹配 → 贡献计入
your_github_username - 向 Gitee 推送 → 邮箱匹配 → 贡献计入
your_gitee_username
用户名不同完全不影响功能，请放心使用。
查看当前配置
git config --global user.name # 输出：your_display_name git config --global user.email # 输出：your_email@example.com
如果邮箱与平台注册邮箱不一致，需要修改：
git config --global user.email "your_correct_email@example.com"
常见问题与解决方案
| 问题现象 | 可能原因 | 解决方案 |
|---|---|---|
Permission denied (publickey) | 公钥未添加到平台，或 IdentityFile 路径错误 | 检查公钥是否完整复制；确认 config 中的路径正确 |
Connection timed out | 22 端口被防火墙屏蔽 | 确认 GitHub 配置中已设置 Port 443 和 HostName ssh.github.com |
PowerShell 中 clip < file 报错 | PowerShell 不支持 < 重定向符 | 改用 `type ~/.ssh/id_rsa.pub |
no such identity | 私钥路径包含反斜杠或中文字符 | 使用正斜杠 /，路径放在英文目录下 |
| 每次 push 还要输密码 | 私钥设置了密码短语（passphrase） | 使用 ssh-agent 缓存密码 |
| 首次连接 GitHub 提示指纹确认 | 通过 443 端口首次访问，主机记录未存入 known_hosts | 输入 yes 确认，此为正常安全机制 |
最终文件结构一览
配置完成后，你的 ~/.ssh 目录应包含以下文件：
~/.ssh/ ├── id_rsa # 私钥（共用，同时服务 Gitee 和 GitHub） ├── id_rsa.pub # 公钥（已分别上传至 Gitee 和 GitHub） ├── known_hosts # 服务器指纹（包含 gitee.com 和 ssh.github.com:443） └── config # SSH 客户端配置（双平台配置）
总结
通过以上步骤，你已经完成了以下全部配置：
- ✅ SSH 密钥在 Gitee 和 GitHub 之间共用
- ✅
~/.ssh/config为两个平台分别指定了正确的认证参数 - ✅ GitHub 使用 443 端口，有效规避防火墙限制
- ✅ 已通过
ssh -T验证双平台连通性 - ✅
git config全局 URL 重写，HTTPS 自动转 SSH - ✅ 全局
user.email与平台注册邮箱一致，贡献记录正常归位
现在，你可以在 Windows 上愉快地使用 Git 操作 Gitee 和 GitHub 的仓库了，无需再为协议、端口和密钥匹配而烦恼。
