本地文件上传到gitee仓库的详细步骤

🔰 一、前期准备

1. 注册 Gitee 账号

访问 Gitee 官网完成注册并登录。
网址：https://gitee.com/

2. 安装 Git

下载 Git 官方客户端并完成安装。
下载网址：https://git-scm.com/downloads

3. 配置 Git 全局信息（首次使用需设置）

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱"

---

🛠️ 二、操作步骤

1. 在 Gitee 创建仓库

• 登录 Gitee → 点击右上角 +→ 选择 新建仓库。

• 填写仓库名称（如 my-project）、描述，选择公开/私有。

• 关键选项：

  • 初始化仓库：不勾选 使用README文件初始化仓库（避免后续冲突）。
  • 忽略文件：按需添加 .gitignore模板（如 Java/Python）。
  • 点击 创建，生成空仓库

2. 初始化本地仓库

# 进入项目根目录
cd /path/to/your/project# 初始化 Git 仓库
git init# 添加所有文件到暂存区
git add .# 提交到本地仓库
git commit -m "Initial commit"

3. 关联远程仓库

# 复制 Gitee 仓库的 HTTPS 地址（格式：https://gitee.com/用户名/仓库名.git）
git remote add origin https://gitee.com/your_username/your_repo.git

4. 推送到 Gitee

# 首次推送（注意分支名）
git push -u origin master   # Git < 2.28 版本
git push -u origin main     # Git ≥ 2.28 版本

• 输入 Gitee 账号密码 或 个人访问令牌（若启用两步验证需用令牌替代密码）
• 注意：如果报错类似如下错

To https://gitee.com/miraclechq/food-app.git! [rejected]        master -> master (non-fast-forward)
error: failed to push some refs to 'https://gitee.com/miraclechq/food-app.git'
hint: Updates were rejected because a pushed branch tip is behind its remote
hint: counterpart. If you want to integrate the remote changes, use 'git pull'
hint: before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

• 这个错误表明你的本地master分支落后于远程仓库的master分支，导致推送被拒绝。以下是解决方案：

• 同步远程更改

   git pull origin master
  

• 这会拉取远程仓库的最新更改并与本地合并

  • 解决冲突后执行：

  git add .
  git commit -m "解决冲突"
  

  • 重新推送‌：

  git push origin master
  

• ‌特殊情况处理‌：

  • 若远程有初始化文件(如README)而本地没有 ，若确定要覆盖远程更改(谨慎使用)：

  <!--先执行下面命令-->
  git pull origin master --allow-unrelated-histories
  <!--再推送-->
  git push -f origin master

5. 验证结果

• 刷新 Gitee 仓库页面，确认文件已成功同步

---

⚠️ 三、关键注意事项

1. 分支名称问题

Git 2.28+ 默认分支为 main，低版本为 master。若推送失败，检查远程仓库默认分支名并调整命令

2. 认证方式选择

   • HTTPS：需每次输入密码（或配置凭证缓存）。

   • SSH（推荐）：通过公钥免密推送（需提前 配置 SSH 密钥）。

   3. 忽略文件配置

   在项目根目录创建 .gitignore文件，列出需忽略的文件（如 node_modules/, .log），避免提交无效文件。

   4.冲突解决

   若远程有初始化文件（如 README），需先拉取合并：

   git pull origin master --allow-unrelated-histories  # 强制合并不相关历史
   # 解决冲突后重新提交推送
   

---

❓ 四、常见问题解决

• fatal: refusing to merge unrelated histories**

  添加 --allow-unrelated-histories参数合并。

• 错误：remote: Incorrect username or password

  • 检查密码或令牌是否正确

    git credential-manager reject  # Windows
    git credential-osxkeychain erase  # macOS
    rm ~/.git-credentials           # Linux
    

• 大文件上传失败

  增大 Git 缓冲区：

  git config --global http.postBuffer 524288000  # 500MB
  

---

💡 总结

完成上述步骤后，本地文件即成功同步至 Gitee。后续更新代码只需：

git add .
git commit -m "更新描述"
git push

保持提交信息清晰，定期拉取远程更新，可高效管理代码版本