【 Git：本地项目上传至 Gitee 仓库】

介绍

本教程提供了一套完整、清晰的操作流程，帮助开发者将本地已有的项目快速上传至 Gitee（码云）仓库，适用于初次使用 Gitee 进行版本控制的用户，也可作为日常操作参考手册。

通过本教程，你将掌握从 Gitee 仓库创建、本地仓库配置到代码推送的全流程，解决上传过程中常见的冲突、版本不兼容等问题，高效实现本地项目的云端管理。

前提条件

1. 本地电脑已安装 Git 客户端（可从 Git 官网 下载）。
2. 已在 Gitee 平台注册账户（注册地址：Gitee 官网）。
3. 本地已完成项目开发（确保项目文件结构完整）。

操作步骤

1. Gitee 端：创建远程仓库

1. 登录 Gitee 账户，点击个人头像旁的「+」号，选择「新建仓库」。
2. 填写仓库基本信息：
   • 仓库名称：填写与本地项目对应的名称（如 Java-Excel-Compare）。
   • 归属：选择个人账号或所属组织。
   • 路径：自动生成（可按需修改，建议与仓库名称一致）。
   • 开源类型：选择「开源」「私有」或「企业内部开源」。
3. 可选配置（按需勾选）：
   • 初始化仓库：可选择添加 .gitignore（按项目语言选择，如 Java）、开源许可证（如 MulanPSL-2.0）。
   • 设置模板：添加 README、Issue 等模板文件。
   • 分支模型：默认选择「单分支模型（仅创建 master 分支）」。
4. 点击「创建」，完成远程仓库创建，获取仓库地址（HTTPS 格式，如 https://gitee.com/用户名/仓库名.git）。

2. 本地端：配置并上传项目

1. 打开本地项目文件夹，右键点击「Git Bash Here」，打开 Git 命令行工具。

2. 初始化本地仓库，将当前目录转为 Git 可管理的仓库：

   git init
   

   执行后会生成隐藏的

   .git
   

   文件夹（需开启「显示隐藏文件」才能查看）。

3. 绑定本地仓库与 Gitee 远程仓库（这里替换为你的仓库地址）：

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

4. 将本地项目所有文件添加到 Git 暂存区：

   git add .
   

   需要注意：. 表示当前目录下所有文件，前面需保留空格。

5. 提交暂存区文件到本地仓库，填写提交说明（描述本次上传内容）：

   git commit -m "项目名即可"
   

6. 同步远程仓库与本地仓库：

   git pull origin master --allow-unrelated-histories
   

   若直接执行 git pull origin master 报错「fatal: refusing to merge unrelated histories」，需添加 --allow-unrelated-histories 参数，解决本地与远程仓库无相关性的问题。

7. 推送本地仓库文件到 Gitee 远程仓库：

   git push origin master
   

3. 验证上传结果

登录 Gitee 账户，进入创建的远程仓库，查看文件列表。若能看到本地项目的所有文件（如 src 目录、配置文件等），说明上传成功。

常见问题解决

1. 拉取时出现合并冲突（如 README.md 冲突）

• 原因：本地与远程仓库的同一文件存在不同内容，比如更新了本地的README.md，但是远程的内容没有更新。

• 解决：

  • 在本地删除 README.md 并提交

  # 删除本地的 README.md 文件
  git rm README.md
  # 提交删除操作
  git commit -m "这里可以写项目名，也可以标注其他的，比如：删除本地 README.md，准备上传新文件"
  

  • 将新的 README.md 复制到本地仓库并提交

  将你本地准备好的新 README.md 文件复制到项目根目录，然后执行

  # 添加新的README.md 到暂存区
  git add README.md
  # 提交新文件
  git commit -m "这里可以写项目名，也可以标注其他的"
  

  • 拉取远程最新更新（避免冲突）

  为了确保远程没有新的更改（防止后续推送冲突），先拉取一次：

  git pull origin master
  

  如果出现冲突，按照提示解决后再提交。

  • 推送本地更改到远程

  git push origin master
  

2. 推送时提示「RPC failed; HTTP 408」

• 原因：项目文件过大，网络传输超时。
• 解决：使用 Git LFS 跟踪大文件，或压缩项目后重新上传，具体操作可参考 Git LFS 官方文档。

3. 绑定远程仓库时提示「fatal: remote origin already exists」

• 原因：本地仓库已绑定过其他远程地址。
• 解决：先删除原有绑定，再重新绑定新仓库地址：

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

参考资料

• Git 官方教程：Git - Book
• 菜鸟教程 Git 入门：Git 教程
• Gitee 官方帮助文档：Gitee 帮助中心