Gitee 本地项目上传与同步实战指南

成功获取到密钥后，前往提示存放的位置找到密钥文件并复制内容。通常位于 ~/.ssh/id_rsa.pub，用记事本打开复制里面的所有内容。

将密钥复制到 Gitee 账号设置中：进入【设置】->【SSH 公钥】->【添加】，粘贴刚才复制的内容。

输入账号密码完成添加。为了验证连接是否成功，回到 Git Bash 界面，输入以下命令：

ssh -T [email protected]

如果显示类似 Hi <用户名>! You've successfully authenticated...，说明连接正常。

配置 Git 全局变量

接下来配置 Git 的用户名和邮箱，这对应你提交代码时的身份信息。

git config --global user.name "你的 Gitee 账号名"
git config --global user.email "Gitee 绑定的邮箱"

可以通过以下命令检验配置是否生效：

git config --list

初始化与推送

在当前目录下初始化 Git 仓库。注意：Git Bash 当前指向的路径就是本地新建立的仓库。

git init

绑定本地仓库与远程仓库。点击新建仓库页面中的【查看代码】，选择 SSH 协议，复制旁边的地址。

git remote add origin [远程仓库的地址]

添加指定文件到暂存区：

git add .

提交更改，填写有意义的备注信息：

git commit -m "初始提交"

最后推送到远程仓库：

git push origin master

推送成功后，刷新 Gitee 页面即可查看代码。

常见问题处理

报错：fatal: refusing to merge unrelated histories

原因： 本地仓库和 Gitee 上的远程仓库没有任何共同的提交历史，Git 认为这是两个完全独立的仓库，因此拒绝合并操作。

解决方案：

方案一：合并不相关历史（推荐）。适合远程仓库已有内容（如 README），不想丢失的情况。

1. 确保本地仓库已关联远程（未关联则先执行，替换为你的 Gitee 仓库地址）：

   git remote add origin https://gitee.com/你的用户名/仓库名.git
   

2. 拉取远程代码，并允许合并不相关历史（核心参数）：

   git pull origin master --allow-unrelated-histories
   

   *注意：分支名默认是 main 或 master，请确认自己的分支名称。

3. 如果出现合并冲突（比如本地和远程都有 README.md），打开冲突文件，保留需要的内容并删除冲突标记（<<<<<<< HEAD, =======, >>>>>>> origin/master）。

4. 解决冲突后提交：

   git add .
   git commit -m "解决合并冲突，合并本地与远程不相关历史"
   

5. 再次推送文件到 Gitee：

   git push origin master
   

方案二：强制覆盖远程仓库（慎用）。仅当远程仓库内容无用，只想把本地文件完全上传覆盖远程时使用。

git push -f origin master

*这会删除远程的所有内容，请务必谨慎操作。