介绍
本教程提供操作流程,帮助开发者将本地已有项目快速上传至 Gitee(码云)仓库。适用于初次使用 Gitee 进行版本控制的用户,也可作为日常操作参考手册。
前提条件
操作步骤
1. Gitee 端:创建远程仓库
- 登录 Gitee 账户,点击个人头像旁的「+」号,选择「新建仓库」。
- 填写仓库基本信息:
- 仓库名称:填写与本地项目对应的名称(如
Java-Excel-Compare)。 - 归属:选择个人账号或所属组织。
- 路径:自动生成(可按需修改,建议与仓库名称一致)。
- 开源类型:选择「开源」「私有」或「企业内部开源」。
- 仓库名称:填写与本地项目对应的名称(如
- 可选配置(按需勾选):
- 初始化仓库:可选择添加
.gitignore(按项目语言选择,如 Java)、开源许可证(如 MulanPSL-2.0)。 - 设置模板:添加 README、Issue 等模板文件。
- 分支模型:默认选择「单分支模型(仅创建 master 分支)」。
- 初始化仓库:可选择添加
- 点击「创建」,完成远程仓库创建,获取仓库地址(HTTPS 格式,如
https://gitee.com/用户名/仓库名.git)。
2. 本地端:配置并上传项目
- 打开本地项目文件夹,右键点击「Git Bash Here」,打开 Git 命令行工具。
- 初始化本地仓库,将当前目录转为 Git 可管理的仓库:
执行后会生成隐藏的git init.git文件夹(需开启「显示隐藏文件」才能查看)。 - 将本地项目所有文件添加到 Git 暂存区:
注意:git add ..表示当前目录下所有文件,前面需保留空格。 - 提交暂存区文件到本地仓库,填写提交说明(描述本次上传内容):
git commit -m "项目名即可" - 绑定本地仓库与 Gitee 远程仓库(替换为你的仓库地址):
git remote add origin https://gitee.com/用户名/仓库名.git - 推送本地仓库文件到 Gitee 远程仓库:
若提示冲突,可能需要先拉取远程更新:git push origin mastergit pull origin master --allow-unrelated-histories
3. 验证上传结果
登录 Gitee 账户,进入创建的远程仓库,查看文件列表。若能看到本地项目的所有文件(如 src 目录、配置文件等),说明上传成功。
常见问题解决
1. 拉取时出现合并冲突(如 README.md 冲突)
- 原因:本地与远程仓库的同一文件存在不同内容,比如更新了本地的 README.md,但是远程的内容没有更新。
- 解决:
将你本地准备好的新 文件复制到项目根目录,然后执行: 为了确保远程没有新的更改(防止后续推送冲突),先拉取一次: 如果出现冲突,按照提示解决后再提交:git README.md git commit -m


