在 Windows MINGW64 环境下，通过 SSH 将本地 Git 仓库推送到 Gitee 的完整流程。涵盖初始化仓库、配置用户信息、生成并上传 SSH 密钥、解决分支冲突及验证推送结果等关键步骤，同时对比了 HTTPS 与 SSH 连接方式的区别，帮助开发者快速上手版本控制协作。
本文旨在介绍将本地新建的 Git 仓库推送到 Gitee 远程仓库的完整流程。过程中涉及 SSH 公钥认证配置、分支冲突处理及命令规范等关键点，以下是详细操作步骤和知识点解析。
# 进入本地项目目录
cd /d/Gits2
# 初始化空 Git 仓库
git init
# 输出：Initialized empty Git repository in D:/Gits2/.git/
# 配置用户名（--local 表示仅当前仓库生效）
git config --local user.name "your_username"
# 配置邮箱（注意参数为 -C 大写）
git config --local user.email "[email protected]"
# 查看配置是否生效
cat .git/config
# 关联远程仓库（SSH 地址，替换为自己的 Gitee 仓库地址）
git remote add origin [email protected]:your_username/test1.git
# 验证远程仓库关联结果
git remote -v
# 输出：origin [email protected]:your_username/test1.git (fetch)
# origin [email protected]:your_username/test1.git (push)
执行 git push 时提示：[email protected]: Permission denied (publickey)，原因是本地未生成 SSH 密钥或公钥未配置到 Gitee。
错误命令示例：
ssh -keygen（应为 ssh-keygen）-c（应为 -C）正确命令：
# 生成 ed25519 算法密钥（推荐，安全性高）
ssh-keygen -t ed25519 -C "[email protected]"
# 若系统不支持 ed25519，改用 RSA 算法（兼容性更好）
ssh-keygen -t rsa -b 4096 -C "[email protected]"
交互步骤（全程回车即可）：
# 复制 ed25519 公钥（若为 RSA 则替换为 id_rsa.pub）
cat ~/.ssh/id_ed25519.pub | clip
ssh-ed25519/ssh-rsa 开头）；# 正确命令
ssh -T [email protected]
# 成功输出应包含 Hi your_username(@your_username)!
# 将所有文件添加到暂存区
git add .
# 提交到本地仓库
git commit -m "1.commit"
直接推送提示：! [rejected] master -> master (fetch first)，原因是远程仓库有本地未同步的内容。
# 拉取远程 master 分支并合并（解决无共同历史问题）
git pull origin master --allow-unrelated-histories
# 合并后重新推送
git push -u origin master
讲解：
--allow-unrelated-histories：必须加！因为本地和远程是独立创建的，无共同提交历史。Esc → 输入 :wq 保存。# 强制推送本地 master 到远程 master
git push -u origin master -f
讲解：
-f：强制推送，会覆盖远程仓库所有未同步内容，多人协作禁止使用。# 查看远程仓库信息
git remote show origin
# 查看本地文件列表
ll
讲解：
tracked：表示本地分支已跟踪远程分支。up to date：表示本地与远程内容已同步。| 错误提示 | 原因 | 解决方案 |
|---|---|---|
bash: shh: command not found | ssh拼写为shh | 修正为ssh -T [email protected] |
Bad escape character 'ygen' | ssh-keygen写成ssh -keygen | 去掉空格，执行ssh-keygen -t ed25519 -C "邮箱" |
Too many arguments | 注释参数用小写-c | 修正为ssh-keygen -t ed25519 -C "邮箱" |
Permission denied (publickey) | SSH 公钥未配置 | 重新生成密钥→复制公钥→Gitee 配置公钥→测试 SSH 连接 |
master -> master (fetch first) | 远程仓库有本地未同步内容 | 方案 1：git pull origin master --allow-unrelated-histories；方案 2：git push -u origin master -f（谨慎） |
HTTPS 和 SSH 是 Git 连接远程仓库的两种核心方式，核心区别集中在认证方式、安全性和便捷性上。
| 对比维度 | HTTPS | SSH |
|---|---|---|
| 认证方式 | 账号密码或访问令牌 | 公钥 + 私钥，密钥对认证 |
| 安全性 | 传输加密，但密码易泄露 | 传输加密 + 密钥存储，私钥本地，更安全 |
| 配置难度 | 极低，只需克隆地址 | 中等，需生成密钥并上传公钥 |
| 使用便捷性 | 每次推送可能需输入凭证 | 配置完成后终身免密 |
| 适用场景 | 临时使用、公共仓库 | 长期开发、个人/团队仓库 |
git pull 合并，再 git push；git config --global core.autocrlf true（Windows）；.ssh 文件夹中的私钥建议备份；--global 参数配置。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML转Markdown 互为补充。 在线工具，Markdown转HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML转Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online