使用 GitHub Desktop 创建您的第一个仓库

简介

GitHub Desktop 是一款免费、开源的应用程序，可帮助您使用托管在 GitHub 或其他 Git 托管服务上的代码。使用 GitHub Desktop，您可以在图形用户界面中执行 Git 命令（例如提交和推送更改），而无需使用命令行。欲了解更多信息，请参阅关于 GitHub Desktop。

通过本指南的学习，您将使用 GitHub Desktop 创建仓库、对仓库进行更改并将更改发布到 GitHub。

在安装 GitHub Desktop 并登录 GitHub 或 GitHub Enterprise 后，您可以创建并克隆一个教程仓库。该教程将介绍使用 Git 和 GitHub 的基础，包括安装文本编辑器、创建分支、进行提交、推送到 GitHub，以及打开拉取请求。如果您在 GitHub Desktop 中尚未拥有任何仓库，教程将可用。

我们建议完成教程，但如果您想通过创建新仓库来探索 GitHub Desktop，本指南将引导您使用 GitHub Desktop 来处理 Git 仓库。

第 1 部分：安装 GitHub Desktop 并验证您的账户

您可以在任何受支持的操作系统上安装 GitHub Desktop。安装应用后，您需要登录并验证您在 GitHub 或 GitHub Enterprise 上的账户，才能创建并克隆教程仓库。

有关安装和验证的更多信息，请参阅设置 GitHub Desktop。

第 2 部分：创建新仓库

如果您在 GitHub Desktop 中还没有任何仓库，您将看到 “让我们开始！” 视图，您可以选择创建并克隆一个教程仓库、从网络克隆现有仓库、创建新仓库，或从硬盘添加现有仓库。

Screenshot of the "Let's get started!" view in GitHub Desktop.

创建并克隆教程仓库

我们建议您将创建并克隆教程仓库作为第一个项目，以练习使用 GitHub Desktop。

点击 创建教程仓库...。
按照教程中的提示安装文本编辑器、创建分支、编辑文件、进行提交、发布到 GitHub，并打开拉取请求。

创建新仓库

如果您不想创建并克隆教程仓库，也可以创建一个新仓库。

点击 在硬盘上创建新仓库...。
在 “创建新仓库” 窗口中，填写相应字段并选择您偏好的选项。
- “Name” 定义了您仓库在本地和 GitHub 上的名称。
- “Description” 是可选字段，您可以在此提供有关仓库用途的更多信息。
- “Local path” 设置仓库在您电脑上的存放位置。默认情况下，GitHub Desktop 会在您的 Documents 文件夹内创建一个 GitHub 文件夹来存放仓库，但您可以选择计算机上的任意位置。新仓库会在所选位置下创建一个文件夹。例如，若将仓库命名为 Tutorial，则会在您选择的本地路径文件夹内创建名为 Tutorial 的文件夹。GitHub Desktop 会记住您下次创建或克隆仓库时所选的位置。
- 使用 README 初始化此仓库 会创建包含 README.md 文件的初始提交。README 有助于人们了解项目的目的，建议选中并填写有用的信息。当有人访问 GitHub 上的仓库时，README 是他们首先看到的内容。更多信息请参阅关于仓库 README 文件。
- Git ignore 下拉菜单允许您添加自定义的忽略文件，以排除本地仓库中不想纳入版本控制的文件。如果您使用特定语言或框架，可从列表中选择相应选项。刚入门时可直接跳过此步骤。更多信息请参阅忽略文件。
- License 下拉菜单让您向仓库中添加开源许可证的 LICENSE 文件。您无需立刻添加许可证。有关可用开源许可证及如何将其添加到仓库的更多信息，请参阅为仓库授权。
点击 创建仓库。

第 3 部分：探索 GitHub Desktop

在屏幕顶部的文件菜单中，您可以访问 GitHub Desktop 的设置以及可执行的操作。大多数操作也都有键盘快捷键，以帮助您更高效地工作。完整的键盘快捷键列表请参阅 GitHub Desktop 键盘快捷键。

GitHub Desktop 仓库栏

在 GitHub Desktop 应用的顶部，您会看到显示当前仓库状态的栏。

Screenshot of the GitHub Desktop app. A bar showing details for the "hello-world" repository spans the top of the window, and is outlined in orange.

Current repository 显示您正在工作的仓库名称。单击 Current repository 可在 GitHub Desktop 中切换到其他仓库。
Current branch 显示您正在工作的分支名称。单击 Current branch 可以查看仓库中的所有分支、切换到其他分支或创建新分支。创建拉取请求后，也可以通过单击 Current branch 查看这些请求。
Publish repository 会出现，因为您尚未将仓库发布到 GitHub，稍后将在下一步完成。该栏的内容会根据当前分支和仓库的状态而变化，可提供不同的上下文相关操作，以在本地和远程仓库之间交换数据。

Changes and History

在左侧侧栏，您可以找到 Changes（更改）和 History（历史）视图。

Screenshot of the GitHub Desktop app. A sidebar on the left-hand side, with tabs labeled "Changes" and "History", is outlined in orange.

Changes 视图显示您在当前分支对文件所做的、但尚未提交到本地仓库的更改。底部有一个带有 “Summary” 与 “Description” 文本框的框，以及一个 Commit to BRANCH（提交到分支）按钮。这里是提交新更改的地方。Commit to BRANCH 按钮会动态显示您正在提交更改的分支名称。
History 视图展示当前分支的历史提交。您应该能看到在创建仓库时 GitHub Desktop 自动生成的 “Initial commit”。在提交右侧，根据您创建仓库时选择的选项，可能会显示 .gitattributes、.gitignore、LICENSE 或 README 文件。单击任意文件即可查看该文件的差异（diff），即该次提交对文件所做的更改，差异仅显示改变的部分，而非整个文件内容。

第 4 部分：将您的仓库发布到 GitHub

当您创建新仓库时，它仅存在于您的电脑上，只有您能够访问。将仓库发布到 GitHub 可实现多台电脑之间的同步，并允许其他人访问。要发布仓库，请将本地更改推送到 GitHub。

在仓库栏中，点击 Publish repository。
在 “Publish Repository” 窗口中，输入新仓库的详细信息。
- GitHub Desktop 会自动填充 “Name” 与 “Description” 字段，使用您创建仓库时输入的信息。
- Keep this code private 让您控制谁可以查看项目。如果不选此项，GitHub 上的其他用户将能够查看您的代码；选中后，代码将不对公众公开。
- 如果出现 Organization 下拉菜单，您可以将仓库发布到自己所在的某个 GitHub 组织。
1. 点击 Publish Repository。
2. 您可以在 GitHub Desktop 中直接访问 GitHub 上的仓库。打开文件菜单，点击 Repository，然后点击 View on GitHub，即可在默认浏览器中打开该仓库页面。

第 5 部分：进行、更改、提交并推送更改

现在您已经创建并发布了仓库，可以开始对项目进行更改，并准备在仓库中制作第一次提交。

要从 GitHub Desktop 启动外部编辑器，请在 “GitHub Desktop” 菜单栏中选择 Repository，然后点击 Open in EDITOR。更多信息请参阅在 GitHub Desktop 中配置默认编辑器。
对之前创建的 README.md 文件进行一些更改。您可以添加描述项目的内容，例如项目的功能以及为何有用。完成更改后，在文本编辑器中保存。
在 GitHub Desktop 中，切换到 Changes 视图。文件列表中应能看到您的 README.md。文件左侧的复选框表示该文件的更改将包含在即将提交的提交中。以后您可能会对多个文件进行更改，但只想提交其中的一部分。若取消选中某文件的复选框，该文件将不被包含在提交中。
在 Changes 列表底部，输入提交信息。您的头像右侧输入简短的提交说明。因为我们正在修改 README.md，可以使用 “Add information about purpose of project” 之类的摘要。摘要下面是 “Description” 文本框，您可以在此输入更详细的描述，以便日后回顾项目历史时了解更改原因。由于只是对 README.md 进行基础更新，您可以省略描述。
在提交信息下方，点击 Commit to BRANCH NAME。该提交按钮会显示当前分支，确保您提交到正确的分支。
要将更改推送到 GitHub 上的远程仓库，点击 Push origin。
- Push origin 按钮与您之前用于发布仓库的按钮相同。它会根据您在 Git 工作流中的位置动态显示。此时它会显示 Push origin 并带有 1，表示有一个提交尚未推送到 GitHub。
- “origin” 在 Push origin 中指的是您正在向名为 origin 的远程推送更改，在本例中即您项目在 GitHub 上的仓库。只要未将新提交推送到 GitHub，您本地机器上的仓库与 GitHub 上的仓库就会存在差异。这使您可以在本地工作，并在准备好时再将更改推送到 GitHub。
在 Changes 视图右侧的窗口中，您会看到下一步可以执行的操作建议。若要在浏览器中打开 GitHub 上的仓库，点击 View on GitHub。
在浏览器中，点击 2 commits。您将看到该仓库在 GitHub 上的提交列表。第一条提交应当是您刚刚在 GitHub Desktop 中完成的提交。