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

您可以使用 GitHub Desktop 创建和管理 Git 仓库，而无需使用命令行。

本文中

简介

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

在本指南的最后，您将使用 GitHub Desktop 创建一个仓库，对仓库进行更改，并将更改发布到 GitHub。

安装 GitHub Desktop 并登录 GitHub 或 GitHub Enterprise 后，你可以创建和克隆教程存储库。该教程将介绍使用 Git 和 GitHub 的基础知识，包括安装文本编辑器、创建分支、提交、推送到 GitHub.com 以及打开拉取请求。如果你在 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。

  1. 单击创建教程存储库...。
  2. 按照教程中的提示安装文本编辑器、创建分支、编辑文件、提交、发布到 GitHub 并打开拉取请求。

创建新存储库

如果你不想创建和克隆教程存储库，你可以创建一个新存储库。

  1. 单击在你的硬盘驱动器上创建新存储库...。
  2. 在“创建新存储库”窗口中，填写字段并选择你喜欢的选项。
    • “名称”定义了你的存储库在本地和 GitHub 上的名称。
    • “说明”是一个可选字段，你可以使用它来提供有关你的存储库用途的更多信息。
    • “本地路径”设置你的存储库在计算机上的位置。默认情况下，GitHub Desktop 在你的文档文件夹内创建一个GitHub文件夹来存储你的存储库，但你可以在计算机上选择任何位置。你的新存储库将是所选位置内的文件夹。例如，如果你将你的存储库命名为Tutorial，则在为本地路径选择的文件夹内会创建一个名为Tutorial的文件夹。当你下次创建或克隆新存储库时，GitHub Desktop 会记住你选择的位置。
    • 使用自述文件初始化此存储库会创建一个初始提交，其中包含一个README.md文件。自述文件有助于人们了解项目的用途，因此我们建议选择此选项并用有用的信息填充它。当有人访问你在 GitHub 上的存储库时，自述文件是他们在了解你的项目时会看到的第一个内容。有关详细信息，请参阅“关于自述文件”。
    • Git 忽略下拉菜单允许你添加一个自定义文件，以忽略本地存储库中你不希望存储在版本控制中的特定文件。如果你将使用特定的语言或框架，则可以选择可用列表中的一个选项。如果你刚开始，可以跳过此选择。有关详细信息，请参阅“忽略文件”。
    • 许可证下拉菜单允许你将开源许可证添加到存储库中的 LICENSE 文件。你无需立即添加许可证。有关可用开源许可证及其如何添加到存储库的详细信息，请参阅“许可证存储库”。
  3. 单击创建存储库。

第 3 部分：探索 GitHub Desktop

在屏幕顶部的文件菜单中，你可以访问可以在 GitHub Desktop 中执行的设置和操作。大多数操作还具有键盘快捷键，以帮助你更有效地工作。有关键盘快捷键的完整列表，请参阅“GitHub Desktop 键盘快捷键”。

GitHub Desktop 存储库栏

在 GitHub Desktop 应用程序的顶部，你将看到一个栏，显示存储库的当前状态。

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

  • 当前存储库显示你正在处理的存储库的名称。你可以单击当前存储库以切换到 GitHub Desktop 中的其他存储库。
  • 当前分支显示你正在处理的分支的名称。你可以单击当前分支以查看存储库中的所有分支、切换到其他分支或创建新分支。一旦在存储库中创建拉取请求，你还可以通过单击当前分支来查看这些请求。
  • 发布存储库出现是因为你尚未将存储库发布到 GitHub，你将在下一步中执行此操作。栏的此部分将根据当前分支和存储库的状态而改变。将提供不同的上下文相关操作，让你可以在本地和远程存储库之间交换数据。

更改和历史记录

在左侧边栏中，您会找到更改和历史记录视图。

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

  • 更改视图显示您对当前分支中的文件所做的更改，但尚未提交到本地存储库。在底部，有一个包含“摘要”和“说明”文本框以及提交到分支按钮的框。您将在此处提交新的更改。提交到分支按钮是动态的，并将显示您要提交更改到的分支。
  • 历史记录视图显示存储库当前分支上的先前提交。您应该会看到一个“初始提交”，该提交是在您创建存储库时由 GitHub Desktop 创建的。在提交的右侧，根据您在创建存储库时选择的选项，您可能会看到.gitattributes、.gitignore、LICENSE 或 README 文件。您可以单击每个文件以查看该文件的差异，即在该提交中对文件所做的更改。差异仅显示文件已更改的部分，而不是文件的全部内容

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

当您创建新存储库时，它仅存在于您的计算机上，并且只有您可以访问该存储库。您可以将您的存储库发布到 GitHub 以使其在多台计算机上保持同步，并允许其他人访问它。要发布您的存储库，请将您的本地更改推送到 GitHub。

  1. 在存储库栏中，单击发布存储库。
    Screenshot of the repository bar. A button, labeled "Publish repository", is highlighted with an orange outline.
  2. 在“发布存储库”窗口中，输入新存储库的详细信息。
    • GitHub Desktop 会自动使用您在创建存储库时输入的信息填充“名称”和“说明”字段。
    • 保持此代码为私有允许您控制谁可以查看您的项目。如果您不选择此选项，GitHub 上的其他用户将能够查看您的代码。如果您选择此选项，您的代码将不会公开。
    • 组织下拉菜单（如果存在）允许您将存储库发布到您在 GitHub 上所属的特定组织。
    1. 单击发布存储库。
    2. 您可以在 GitHub Desktop 中从 GitHub.com 访问存储库。在文件菜单中，单击存储库，然后单击在 GitHub 上查看。这会将您直接带到默认浏览器中的存储库。

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

现在您已经创建并发布了您的存储库，您就可以对您的项目进行更改，并开始对您的存储库进行第一次提交。

  1. 要在 GitHub Desktop 中从外部编辑器启动，请在“GitHub Desktop”菜单栏中，选择存储库，然后单击在编辑器中打开。有关更多信息，请参阅“在 GitHub Desktop 中配置默认编辑器”。

    Screenshot of a menu bar on a Mac. Under the open "Repository" dropdown menu, a cursor hovers over "Open in Visual Studio Code", highlighted in blue.

  2. 对您之前创建的README.md 文件进行一些更改。您可以添加描述您的项目的信息，例如它的作用和用途。当您对更改感到满意时，请在文本编辑器中保存它们。

  3. 在 GitHub Desktop 中，导航到更改视图。在文件列表中，你应该看到你的README.md。README.md 文件左侧的复选框表示你对该文件所做的更改将成为你所提交内容的一部分。将来，你可能会对多个文件进行更改，但只想提交你对其中一些文件所做的更改。如果你单击文件旁边的复选框，则该文件将不会包含在提交中。

    Screenshot of the "Changes" tab in the sidebar. To the left of the "README.md" file, a selected checkbox is highlighted with an orange outline.

  4. 在更改列表的底部，输入提交消息。在你的个人资料图片的右侧，键入提交的简短描述。由于我们正在更改README.md 文件，“添加有关项目目的的信息”将是一个很好的提交摘要。在摘要下方，你将看到一个“描述”文本字段，你可以在其中键入提交中更改的更长的描述，这在回顾项目历史并了解为何进行更改时很有帮助。由于你正在对README.md 文件进行基本更新，因此你可以跳过描述。

    Screenshot of the "Changes" tab in the sidebar. To the right of a profile picture, a text field containing a commit message is outlined in orange.

  5. 在你的提交消息下方，单击提交到分支名称。提交按钮显示你的当前分支，因此你可以确保提交到所需的的分支。

  6. 要将你的更改推送到 GitHub 上的远程存储库，请单击推送原点。

    Screenshot of the "Repository" menu bar. A button, labeled "Push origin", is highlighted with an orange outline.

    • 推送原点按钮与你单击以将存储库发布到 GitHub 的按钮相同。此按钮会根据你在 Git 工作流中的位置而按上下文进行更改。它现在应该显示推送原点，其旁边有一个1，表示有一个提交尚未推送到 GitHub。
    • 推送原点中的“原点”表示你正在将更改推送到名为原点的远程，在本例中，它是 GitHub.com 上的项目存储库。在你将任何新提交推送到 GitHub 之前，你的计算机上的项目存储库和 GitHub.com 上的项目存储库之间将存在差异。这允许你在本地工作，并且仅在你准备好时才将你的更改推送到 GitHub.com。

  7. 在更改视图右侧的窗口中，你将看到有关你可以执行的后续操作的建议。若要在浏览器中打开 GitHub 上的存储库，请单击在 GitHub 上查看。

    Screenshot of the "No local changes" screen. In a list of suggestions, a button, labeled "View on GitHub", is highlighted with an orange outline.

  8. 在浏览器中，单击2 次提交。您将在 GitHub 上看到此存储库中的提交列表。第一个提交应该是您刚刚在 GitHub Desktop 中进行的提交。

    Screenshot of the repository page on GitHub. Above the list of files and next to a clock icon, a link, labeled "2 commits", is outlined in orange.

结论

您现在已创建了一个存储库，将存储库发布到 GitHub，进行了一次提交，并将您的更改推送到 GitHub。在为其他您创建或协作的项目做出贡献时，您可以遵循此相同的工作流程。

延伸阅读