Skip to main content
我们经常发布文档更新，此页面的翻译可能仍在进行中。有关最新信息，请访问英文文档。如果此页面上的翻译有问题，请告诉我们。
Enterprise Server 3.1
简体中文
� 
Get started
Enterprise Server 3.1
简体中文

� 

此版本的 GitHub Enterprise 已停止服务 2022-06-03. 即使针对重大安全问题，也不会发布补丁。 要获得更好的性能、改进的安全性和新功能，请升级到 GitHub Enterprise 的最新版本。 如需升级方面的帮助，请联系 GitHub Enterprise 支持。

Hello World

本文内容

按照此 Hello World 练� 开始使用 GitHub Enterprise Server。

简介

GitHub Enterprise Server 是一个用于版本控制和协作的代� �托管平台。 它允许您和其他人随时随地协同处理项目。

本教程培训 GitHub Enterprise Server 的基本知识，如存储库、分支、提交和拉取请求等。 您将创建自己的 Hello World 存储库，并了解 GitHub Enterprise Server 的拉取请求工作流，这是创建和查看代� �的常用方法。

在本快速入门指南中，您将：

  • 创建和使用存储库
  • 启动和管理新分支
  • 对文件进行更改并将其作为提交推送到 GitHub Enterprise Server
  • 打开与合并拉取请求

要完成本教程，您需要 GitHub Enterprise Server 帐户和连接互联网。 您不需要知道如何编� �、使用命令行或安装 Git（构建 GitHub Enterprise Server 的版本控制软件）。 如果您对本指南中使用的任何表达方式有疑问，请转到词汇表了解术语的更多信息。

创建仓库

存储库通常用于组织单个项目。 存储库可以包含文件夹和文件、图像、视频、电子表� �和数据集 - 项目所需的任何内容。 通常，存储库包括一个 README 文件，其中含项目的相关信息。 README 文件以纯文本 Markdown 语言编写。 您可以使用此备忘单开始使用 Markdown 语法。 GitHub Enterprise Server 允许您在创建新存储库的同时添�  README 文件。 GitHub Enterprise Server 还提供了其他常用选项，例如许可证文件，但您现在不必选择其中任何一个。

您的 hello-world 存储库可以是您存储想法、资源甚至与他人共享和讨论的地方。

  1. 在任何页面的右上角，使用 下拉菜单选择 New repository（新建仓库）。 带有创建新仓库选项的下拉菜单

  2. 在 Repository name（存储库名称）框中，输入 hello-world。

  3. 在 Description（说明）框中，编写简短说明。

  4. 选择 Add a README file（添�  README 文件）。

  5. 选择您的存储库是公有还是私有。

  6. 单击 Create repository（创建仓库）。

    创建 hello world 存储库

创建分支

通过分支，您可以同时拥有不同版本的存储库。

默认情况下，存储库有一个名为 main 的分支，被视为最终分支。 您可以在存储库中创建 main 以外的其他分支。 您可以使用分支一次拥有项目的不同版本。 当您想要在不更改主要代� �源的情况下向项目添� 新功能时，这非常有用。 在合并主分支之前，在不同分支上完成的工作不会显示在主分支上，我们将在本指南的后面部分介绍。 您可以使用分支进行试验和编辑，然后再将其提交到 main。

当您创建 main 分支以外的分支时，创建的是 main 在当时的副本或快照。 如果其他人在您处理分支时对 main 分支进行了更改，您可以拉入这些更新。

此图显示：

  • main 分支
  • 一个名为 feature 的新分支
  • feature 在合并到 main 之前的历程

分支图

您是否曾经保存过文件的不同版本？ 像这� �：

  • story.txt
  • story-edit.txt
  • story-edit-reviewed.txt

分支在 GitHub Enterprise Server 存储库中实现了类似的目� �。

在 GitHub Enterprise Server，我们的开发人员、编写者和设计师使用分支将错误修复和功能工作与我们的 main（生产）分支分开。 当更改准备就绪时，他们会将其分支合并到 main。

创建分支

  1. 单击 hello-world 存储库的 Code（代� �）选项卡。
  2. 单击其中显示 main 的文件列表顶部的下拉列表。 分支菜单
  3. 在文本框中键入分支名称 readme-edits。
  4. 单击 Create branch: readme-edits from main（创建分支：从 main 创建 readme-edits）。

分支菜单

此时您有两个分支：main 和 readme-edits。 现在，它们看起来完全相同。 接下来，您将向新分支添� 更改。

创建和提交更改

在上一步中创建新分支时， GitHub Enterprise Server 会将您带到作为 main 副本的新 readme-edits 分支的代� �页。

您可以对存储库中的文件进行更改并保存更改。 在 GitHub Enterprise Server 上，保存的更改称为提交。 每个提交都有一个关联的提交消息，该消息是解释为什么进行特定更改的说明。 提交消息会捕获您更改的历史记录，以便其他参与者可以了解您执行了哪些操作及其原� 。

  1. 在您创建的 readme-edits 分支下，单击 README.md 文件。

  2. 单击 编辑文件。

  3. 在编辑器中，编写一些关于您自己的内容。 尝试使用不同的 Markdown 元� 。

  4. 在 Commit changes（提交更改） 框中，编写描述更改的提交消息。

  5. 单击 Commit changes（提交更改）。

    提交示例

这些更改将仅适用于 readme-edits 分支上的 README 文件，所以这个分支现在包含不同于 main 的内容。

打开拉取请求

现在，您在 main 以外的分支中进行了更改，可以打开拉取请求。

拉取请求是 GitHub Enterprise Server 上协作的� �心。 打开拉取请求后，可以提出更改，要求某人审查和提取您的贡献并将其合并到其分支中。 拉取请求显示两个分支中内容的差异。 变化、增减以不同的颜色显示。

只要进行提交，便可打开拉取请求并开始讨论，即使在代� �完成之前亦可。

通过在拉取请求消息中使用 GitHub Enterprise Server 的 @提及功能，您可以向特定人员或团队请求反馈，� 论他们近在大厅还是远在 10 个时区之外。

您甚至可以在自己的存储库中打开拉取请求并自行合并。 这是在处理大型项目之前了解 GitHub Enterprise Server 流程的好方法。

  1. 单击 hello-world 存储库的 Pull requests（拉取请求）选项卡。

  2. 单击 New pull request（新拉取请求）。

  3. 在 Example Comparisons（示例比较）框中，选择您创建的分支 readme-edits 以与 main（原始分支）进行比较。

  4. 在 Compare（比较）页面上的差异中查看您的更改，确保它们是您要提交的内容。

    差异示例

  5. 单击 Create pull request（创建拉取请求）。

  6. 为拉取请求指定一个� �题，并写下更改的简要说明。 您可以包含表情符号以及拖放图像和 gif。

  7. （可选）在� �题和说明右侧，单击 Reviewers（审查者）旁边的 。 单击 Assignees（受理人）、Labels（� �签）、Projects（项目）或 Milestone（里程碑）以将这些选项添� 到您的拉取请求。 您不需要添� 任何内容，但这些选项提供了使用拉取请求进行协作的不同方式。 更多信息请参阅“关于拉取请求”。

  8. 单击 Create pull request（创建拉取请求）。

您的协作者现在可以查看您的编辑内容并提出建议。

合并拉取请求

在最后一步中，您将 readme-edits 分支合并到 main 分支中。 合并拉取请求后，readme-edits 分支上的更改将合并到 main。

有时，拉取请求可能会引入与 main 上现有代� �冲突的代� �更改。 如果存在任何冲突， GitHub Enterprise Server 将提醒您有关冲突代� �的信息，并防止合并，直到冲突解决为止。 您可以进行解决冲突的提交，也可以使用拉取请求中的注释与团队成员讨论冲突。

在本演练中，应该没有任何冲突，� 此您已准备好将分支合并到主分支中。

  1. 单击 Merge pull request（合并拉取请求），将更改合并到 main。 合并按钮的屏幕截图。
  2. 单击 Confirm merge（确认合并）。 您将收到一条消息，指出请求已成功合并且请求已关闭。
  3. 单击 Delete branch（� 除分支）。 现在，您的拉取请求已合并，并且您的更改位于 main 上，您可以安全地� 除 readme-edits 分支。 如果要对项目进行更多更改，可以随时创建新分支并重复此过程。

后续步骤

通过完成本教程，您已经学会了创建项目和在 GitHub Enterprise Server 上发出拉取请求。

以下是您在本教程中完成的工作：

  • 创建了一个开源仓库
  • 启动并管理了新的分支
  • 更改了文件并将这些更改提交到 GitHub Enterprise Server
  • 打开并合并了拉取请求

查看您的 GitHub Enterprise Server 个人资料，将会看到您的工作反� 在您的贡献图表上。

有关分支和拉取请求的强大功能的更多信息，请参阅“GitHub 流程”。 有关开始使用 GitHub Enterprise Server 的详细信息，请参阅快速入门中的其他指南。