通过 SSH 方式连接 Gitee（码云）。与 GitHub 类似，配置一次后即可免密推送代码，且支持多账号管理。
一、检查本地是否已有 SSH 密钥
打开终端（Windows 使用 Git Bash 或 PowerShell，macOS/Linux 使用自带终端），执行： ``bash ls -al ~/.ssh ` 如果看到 id_rsa 和 id_rsa.pub（或 id_ed25519 / id_ed25519.pub）文件，说明已有密钥，可跳过第二步。
二、生成新的 SSH 密钥
如果没有密钥，执行以下命令生成（将邮箱替换为你的 Gitee 注册邮箱）：
bash ssh-keygen -t ed25519 -C "your_email@example.com" 如果系统不支持 Ed25519 算法，可使用 RSA： bash ssh-keygen -t rsa -b 4096 -C "your_email@example.com" 按提示操作：
●按回车确认默认路径（~/.ssh/id_ed25519）
●输入密码短语（passphrase，可选，建议设置以增加安全性） 生成成功后，你会看到类似输出：
Your identification has been saved in /Users/you/.ssh/id_ed25519 Your public key has been saved in /Users/you/.ssh/id_ed25519.pub
三、将公钥添加到 Gitee
1. 复制公钥内容：
bash cat ~/.ssh/id_ed25519.pub 复制输出的全部内容（以 ssh-ed25519 或 ssh-rsa 开头，以邮箱结尾）。
2. 登录 Gitee，点击右上角头像 → 设置 → SSH公钥 → 添加公钥。
3. 填写：
●标题：任意标识，如 "My Laptop"
●公钥：粘贴刚才复制的公钥内容
4. 点击 确定 保存，输入 Gitee 密码确认。
四、测试 SSH 连接
执行以下命令测试是否配置成功：
bash ssh -T git@gitee.com 如果看到类似输出： Hi your_username! You've successfully authenticated, but GITEE.COM does not provide shell access. 说明连接成功。如果提示 Permission denied，请检查密钥是否已正确添加到 Gitee。
五、配置本地仓库使用 SSH
在本地仓库中，将远程地址从 HTTPS 改为 SSH： `bash
查看当前远程地址
git remote -v
修改为 SSH 地址（以你的仓库名为准）
git remote set-url origin git@gitee.com:yourusername/yourrepo.git
SSH 地址格式为：git@gitee.com:用户名/仓库名.git 之后推送代码时，无需再输入用户名和密码：bash git push -u origin main `
六、多账号配置（同时使用 Gitee 和 GitHub）
如果你需要同时管理 Gitee 和 GitHub 账号，可以在 ~/.ssh/config 文件中配置不同的密钥。
1. 生成多个 SSH 密钥
`bash
Gitee 账号
ssh-keygen -t ed25519 -C "gitee@example.com" -f ~/.ssh/id_ed25519_gitee
GitHub 账号
ssh-keygen -t ed25519 -C "github@example.com" -f ~/.ssh/id_ed25519_github `
2. 将公钥分别添加到对应平台
●Gitee 公钥：cat ~/.ssh/id_ed25519_gitee.pub → 添加到 Gitee SSH 公钥
●GitHub 公钥：cat ~/.ssh/id_ed25519_github.pub → 添加到 GitHub SSH 公钥
3. 配置 SSH 配置文件
编辑 ~/.ssh/config 文件（如果不存在则新建）： `ini
Gitee 配置
Host gitee.com HostName gitee.com User git IdentityFile ~/.ssh/id_ed25519_gitee
GitHub 配置
Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519_github `
4. 分别测试连接
`bash
测试 Gitee
ssh -T git@gitee.com
应输出：Hi your_gitee_username! You've successfully authenticated...
测试 GitHub
ssh -T git@github.com
应输出：Hi your_github_username! You've successfully authenticated...
`
5. 在仓库中配置远程地址
●Gitee 仓库：git remote set-url origin git@gitee.com:username/repo.git
●GitHub 仓库：git remote set-url origin git@github.com:username/repo.git 之后推送代码时，SSH 会自动根据远程地址中的 Host 选择对应的密钥。
七、常见问题与解决
| 问题 | 原因 | 解决方法 |
| Permission denied (publickey) | 密钥未添加到 Gitee | 检查 ~/.ssh/id_ed25519.pub 是否已添加到 Gitee SSH 公钥 |
| Host key verification failed | 首次连接未知主机 | 输入 yes 确认并继续 |
| 多个账号冲突 | 同一台电脑使用多个账号 | 在 ~/.ssh/config 中配置不同 Host 指向不同密钥 |
| 密钥密码短语每次都要输入 | 未添加到 ssh-agent | 执行 ssh-add ~/.ssh/id_ed25519（可写入 shell 配置文件自动加载） |
八、Gitee 与 GitHub 的 SSH 配置差异
| 对比项 | Gitee | GitHub |
| 测试命令 | ssh -T git@gitee.com | ssh -T git@github.com |
| SSH 地址格式 | git@gitee.com:用户名/仓库.git | git@github.com:用户名/仓库.git |
| 公钥添加位置 | 设置 → SSH公钥 | Settings → SSH and GPG keys |
| 多账号配置 | 使用 Host gitee.com | 使用 Host github.com` |
评论