Windows 10 下 Gitee SSH 连接配置详解（附常见问题解决）

还在每次 git push 时输入账号密码？配置 SSH 密钥后，一键操作，安全又高效。本文手把手带你完成 Windows 10 上 Gitee 的 SSH 连接配置，并解决克隆时仍弹出登录框的典型问题。

一、为什么要使用 SSH？

免密操作 ：配置一次，后续 clone、push、pull 无需再输入用户名和密码。
更安全：使用非对称加密，私钥本地保存，公钥托管在 Gitee，避免密码在网络中传输。
提升效率：尤其适合频繁交互的开发场景。

二、准备工作

1. 安装 Git for Windows

访问 Git 官网下载 64 位安装包。
安装时，在 "调整你的 PATH 环境" 步骤，务必选择 "Git from the command line and also from 3rd-party software"，以便在 PowerShell 或 CMD 中调用 Git 命令。
安装完成后，在桌面右键菜单中应出现 "Git Bash Here" 选项。

2. 检查 Windows 10 自带的 OpenSSH 客户端（可选）

Windows 10 1809 及以上版本已内置 OpenSSH 客户端，可通过 ssh -V 检查。
若没有，Git for Windows 自带 SSH 工具，无需额外安装。

三、生成 SSH 密钥对

打开 PowerShell 或 Git Bash，执行以下命令：

bash 复制代码

ssh-keygen -t ed25519 -C "你的Gitee绑定邮箱"

推荐使用 ed25519 算法，性能与安全性均优于 RSA。-C 后的邮箱仅作为注释，方便识别。

按提示操作：

密钥保存路径 ：默认 ~/.ssh/id_ed25519，直接回车。
密码短语（passphrase）：可留空，直接回车三次（无密码）。

生成成功后会得到两个文件：

id_ed25519 ------ 私钥（妥善保管，勿泄露）
id_ed25519.pub ------ 公钥（待会上传到 Gitee）

四、将公钥添加到 Gitee

登录 Gitee，点击右上角头像 → 设置。
左侧菜单选择 "SSH公钥"。
点击 "添加公钥" ：
- 标题：任意描述，如 "我的 Windows 笔记本"。
- 公钥：将 ~/.ssh/id_ed25519.pub 的内容完整复制粘贴进去。
确认并完成身份验证。

获取公钥内容的命令：

bash 复制代码

cat ~/.ssh/id_ed25519.pub

复制输出内容（以 ssh-ed25519 开头）。

五、验证 SSH 连接

在终端执行：

bash 复制代码

ssh -T git@gitee.com

首次连接 ：会提示确认主机指纹，输入 yes 回车。
成功标志 ：返回类似以下信息：
复制代码
```
Hi 用户名! You've successfully authenticated, but GITEE.COM does not provide shell access.
```
这说明 SSH 认证已通过，可以愉快地使用 Git 了。

六、克隆仓库（关键一步）

此处容易踩坑！ 克隆时请务必使用 SSH 协议地址，而非 HTTPS。

在 Gitee 项目页，点击 "克隆/下载" ，切换到 SSH 标签 ，复制形如 git@gitee.com:用户名/仓库名.git 的地址。

正确克隆命令：

bash 复制代码

git clone git@gitee.com:你的用户名/仓库名.git

七、常见问题：克隆时仍弹出登录框要求输入用户名密码

现象

明明已配置 SSH，但执行 git clone https://gitee.com/... 时，依然弹出 Git 凭据管理器或要求输入账号密码。

原因

HTTPS 和 SSH 是两套独立认证机制。用 HTTPS 地址克隆，Git 自然要求提供 Gitee 账号密码，不会自动走 SSH。

解决方案

方案一：改用 SSH 地址重新克隆

bash 复制代码

# 先删除已存在的目录（若有）
rm -rf 仓库名
# 使用 SSH 地址
git clone git@gitee.com:用户名/仓库名.git

方案二：将已克隆的 HTTPS 仓库远程地址修改为 SSH

如果你已经用 HTTPS 克隆了，可以修改远程地址：

bash 复制代码

cd 仓库目录
git remote set-url origin git@gitee.com:用户名/仓库名.git

之后 git push、git pull 都会走 SSH。

八、进阶：多账号管理（可选）

若你需要在同一台电脑上管理多个 Gitee 账号（如个人和工作），可通过 ~/.ssh/config 文件配置不同 Host 别名。

示例配置：

复制代码

# 个人账号
Host gitee.com
  HostName gitee.com
  User git
  IdentityFile ~/.ssh/id_ed25519_personal

# 工作账号
Host work.gitee.com
  HostName gitee.com
  User git
  IdentityFile ~/.ssh/id_ed25519_work

克隆时使用：

bash 复制代码

git clone git@work.gitee.com:公司组织/仓库.git

九、总结

生成密钥 → ssh-keygen -t ed25519 -C "邮箱"
添加公钥 → Gitee 设置 → SSH 公钥
验证 → ssh -T git@gitee.com
克隆时务必使用 SSH 地址 （git@gitee.com:...），避免误用 HTTPS。

搞定以上步骤，从此告别 Git 操作时的密码输入，让开发流程更加丝滑。如果在配置过程中遇到其他问题，欢迎在评论区留言交流！

📌 本文首发于 CSDN，转载请注明出处。如果觉得有帮助，点个赞支持一下吧！