Hello Gitee 项目

无需编程基础，传承至计算机编程中历史悠久的传统项目 “Hello World”，以此为基础设计了Gitee专属的“Hello Gitee”教程

你将学会以下内容:

1. 创建并使用Gitee仓库
2. 什么是分支及分支的作用
3. 创建新的分支
4. 新分支与主分支之间如何协作

什么是 Gitee

Gitee 是一个版本控制和协作的代码托管平台(不仅可以托管代码，还可以托管文档与图片资料）。 它可以让你和其他人一起在远程或本地项目上进行协作。

本教程将为您介绍 Gitee 的一些基础知识，如：仓库、分支、分支修改确认以及 Pull Request (代码评审）。您将创建自己的 Hello Gitee 仓库，并学习 Gitee 的 Pull Request 工作流

提示：

1. 您可在单独的浏览器窗口打开此页面，以便按步骤操作时进行查看
2. 在创建仓库前确认自己是否绑定了邮箱，若没有可点击右上角头像，进入设置，在“多邮箱配置”中进行设置

五步 Gitee 轻松入门

第一步 创建 Hello Gitee 仓库

仓库可用于存放自己的一个创意或项目的资料库。

仓库内可包含：文件夹和文件，图片，视频，电子文档和代码等你能想到的任何元素。

创建新仓库时建议设置一个 README.md 的文档来介绍您的项目。

（新手默认不选）另外可选开源许可证文件，让你明确声明自己资源他人可以如何使用。

提示：社区版Gitee提供5G的总仓库空间，单文件最大支持50M

详细内容可查看：https://gitee.com/help/articles/4167

>仓库创建步骤

1. 创建名字为 hello-gitee 的仓库
2. 仓库介绍可自定义，或直接填写：入门学习
3. 是否开源选择：公开
4. 勾选使用 Readme 文件初始化这个仓库
5. 点击创建按钮

（其他选项使用默认设置即可）

此时，新建的 hello-gitee 仓库中会有 README.en.md 及 README.md 两个默认 Markdown 格式的文档。我们将在 README.md 文档上进行后续操作。

---

---

第二步 创建一个新分支

分支是给您提供后悔药的一种方式，以自己写的一段文字记录为例，复制出一个一模一样的文档，在新复制出的文档上修改内容，然后再合并到原始文档时，对比两个文档可以看到哪些地方做了修改，如果觉得副本中一些有价值的原始记录内容被删除了，可以继续修改副本，以免一份文档修改后，原本写的有价值的文字也被删除，就得不偿失了。

>创建新分支步骤

1. 点击下图中的“1个分支”进入分支管理界面

---

2. 点击右上角“新建分支”按钮，命名“新分支名称”为：caogao，点击“提交”按钮确认

---

3. 点击新建好的分支名“caogao”，即可进入新分支界面。也可如下图红框所示进行切换：

到这里，一个新的分支就创建好啦！

---

---

第三步 修改分支并提交更改

让我们直奔主题，对新分支的内容进行修改吧！

>分支编辑步骤

1. 点击 caogao 分支的READ.md 文档，如下图位置点击“编辑”按钮

---

2. 在编辑窗口中第二行添加一段内容：I am becoming better！同时删除其他无关的所有文字，完成后点击提交。

---

3. 至此，修改好的第一版 README.md 出炉了，若还需要修改可继续编辑操作。

距离胜利仅剩两步之遥啦，让我们一气呵成完成它！

---

---

第四步 提交 Pull Request

Pull Requests 是 Gitee 上分支操作的一项很重要的功能。我们可以通过审核并通过 Pull Requests 从而进行不同分支的合并。

>提交 Pull Requests 步骤

1. 点击顶部 Pull Requests 进入配置页面，点击右上角“新建 Pull Requests” 创建请求

---

2. 命名本次操作：PR，在文本框中填入备注信息：My first PR.

---

3. 点击右下角创建，首个 Pull Requests 就创建完成了！

---

---

第五步 合并提交的 Pull Request

恭喜你，距离胜利仅一步之遥！

作为仓库的拥有者，在合并提交的 Pull Requests 前一定要确认新分支的修改是否符合自己的期望，如果不符合可以在线反馈自己的意见。

让我们来完成这历史性的一刻吧！

>合并分支操作步骤

1. 进入 Pull Requests 页面，点击可合并的请求

---

2. 可在文件选项中查看提交的分支与 master 分支有什么差别，可通过颜色对比查看

（白色：无修改；红色：删减内容；蓝色：新增内容）

---

3. 确认无误可点击合并按钮，如有疑问可在评论中回复

---

4. 点击合并中的按钮“合并分支”并再次点击“接收 Pull Requests”

---

5. 合并完成后显示为“已合并”，但Gitee依旧提供了强力后悔药“回退”功能（手快不用愁）

恭喜您，大功告成，可以快乐的使用 Gitee 了！

不过瘾？学习更酷的 Gitee 使用方式，传送门：https://gitee.com/mvphp/gitee_advanced