Gitee SSH 推送本地代码完整操作指南

交互步骤（全程回车即可）：

• 指定密钥保存路径：直接回车使用默认路径
• 设置密钥密码：建议留空方便使用，输入回车
• 确认密码：再次回车

4.2 复制公钥到剪贴板

# 复制 ed25519 公钥（若为 RSA 则替换为 id_rsa.pub）
cat ~/.ssh/id_ed25519.pub | clip

4.3 配置 Gitee SSH 公钥

1. 登录 Gitee → 右上角头像 → 「设置」；
2. 左侧菜单 → 「SSH 公钥」；
3. 「标题」：自定义（如 Windows-MINGW64）；
4. 「公钥」：粘贴剪贴板中的公钥内容（以 ssh-ed25519/ssh-rsa 开头）；
5. 点击「确定」并输入密码验证。

4.4 测试 SSH 连接

# 正确命令
ssh -T [email protected]

# 成功输出应包含 Hi your_username(@your_username)!

步骤 5：提交本地代码到暂存区 + 本地仓库

# 将所有文件添加到暂存区
git add .

# 提交到本地仓库
git commit -m "1.commit"

步骤 6：推送本地代码到 Gitee（解决分支冲突）

问题现象

直接推送提示：! [rejected] master -> master (fetch first)，原因是远程仓库有本地未同步的内容。

方案 1：拉取并合并远程内容（推荐）

# 拉取远程 master 分支并合并（解决无共同历史问题）
git pull origin master --allow-unrelated-histories

# 合并后重新推送
git push -u origin master

讲解：

• --allow-unrelated-histories：必须加！因为本地和远程是独立创建的，无共同提交历史。
• 若弹出 vi 编辑器：按 Esc → 输入 :wq 保存。

方案 2：强制推送（覆盖远程内容，谨慎使用）

# 强制推送本地 master 到远程 master
git push -u origin master -f

讲解：

• -f：强制推送，会覆盖远程仓库所有未同步内容，多人协作禁止使用。

步骤 7：验证推送结果

# 查看远程仓库信息
git remote show origin

# 查看本地文件列表
ll

讲解：

• tracked：表示本地分支已跟踪远程分支。
• up to date：表示本地与远程内容已同步。

三、常见错误与解决方案汇总

四、补充：HTTPS 与 SSH 的区别

HTTPS 和 SSH 是 Git 连接远程仓库的两种核心方式，核心区别集中在认证方式、安全性和便捷性上。

五、后续操作建议

1. 避免强制推送：多人协作时优先使用 git pull 合并，再 git push；
2. 换行符配置：若频繁提示 LF/CRLF，可执行 git config --global core.autocrlf true（Windows）；
3. 密钥备份：本地 .ssh 文件夹中的私钥建议备份；
4. 全局配置：若所有仓库使用相同用户名/邮箱，可使用 --global 参数配置。