我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

使用 GitHub Desktop 创建第一个仓库

您可以使用 GitHub Desktop 来创建和管理 Git 仓库,而不是使用命令行。

本文内容

此文档对您有帮助吗?

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。

简介

GitHub Desktop 可扩展并简化您的 GitHub.com 工作流程,它使用可视界面,而不是在命令行上使用命令文本。 在本指南结束时,您已经使用 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 关联的任何仓库,则会看到“让我们开始吧!”视图,您可以在其中选择创建和克隆教程仓库、从 Internet 克隆现有仓库、创建新仓库或从硬盘添加现有仓库。 让我们开始吧 ! screen

创建和克隆教程仓库

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

  1. 单击 Create a tutorial repository and clone it(创建教程仓库并克隆它)
    “创建和克隆教程仓库”按钮
  2. 按照教程中的提示安装文本编辑器、创建分支、 编辑文件、进行提交、发布到 GitHub 以及打开拉取请求。

创建新仓库

如果你不想创建并克隆教程仓库,可以创建一个新的仓库。

  1. 单击 Create a New Repository on your Hard Drive...(在硬盘上创建新仓库...)
    创建新仓库
  2. 填写字段并选择您的首选项。
    创建仓库选项
    • “Name(名称)”定义仓库在本地以及 GitHub 上的名称。
    • “Description(说明)”是一个可选字段,可用于提供有关仓库目的的更多信息。
    • “Local path(本地路径)”设置仓库在计算机上的位置。 默认情况下,GitHub Desktop 会在 Documents 文件夹内创建 GitHub 文件夹,用于存储仓库,但您也可以选择计算机上的任何位置。 您的新仓库将是所选位置内的文件夹。 例如,如果将仓库命名为 Tutorial,则会在为本地路径选择的文件夹内创建一个名为 Tutorial 的文件夹。 下次创建或克隆新仓库时,GitHub Desktop 会记住您选择的位置。
    • Initialize this repository with a README(使用自述文件初始化此仓库)创建包含 README.md 文件的初始提交。 自述文件帮助人们了解项目的目的,因此建议选择此选项并加入有用的信息。 当有人访问您在 GitHub 上的仓库时,自述文件是他们了解您的项目时看到的第一项内容。 更多信息请参阅“关于自述文件”。
    • Git ignore(Git 忽略)下拉菜单可让您添加自定义文件,以忽略本地仓库中您不想存储在版本控制中的特定文件。 如有您要使用的特定语言或框架,您可以从可用的列表中选择选项。 如果刚刚开始,尽请跳过此选择。 更多信息请参阅“忽略文件”。
    • License(许可证)下拉菜单可让您将开源许可证添加到仓库中的 LICENSE 文件。 您无需担心要立即添加许可证。 有关可用开源许可证以及如何将它们添加到仓库的更多信息,请参阅“许可仓库”。
  3. 单击 Create repository(创建仓库)

第 3 部分:探索 GitHub Desktop

在屏幕顶部的文件菜单中,您可以访问在 GitHub Desktop 中可以执行的设置和操作。 大多数操作也有快捷键来帮助您提高工作效率。 有关键盘快捷键的完整列表,请参阅“键盘快捷键”。

GitHub Desktop 菜单栏

在 GitHub Desktop 应用程序的顶部,您将看到一个显示仓库当前状态的栏。

  • Current repository(当前仓库)显示您处理的仓库的名称。 您可以单击 Current repository(当前仓库)切换到 GitHub Desktop 中的不同仓库。

  • Current branch(当前分支)显示您处理的分支的名称。 您可以单击 Current branch(当前分支)来查看仓库中的所有分支、切换到不同的分支或者创建新分支。 在仓库中创建拉取请求后,也可单击 Current branch(当前分支)查看它们。

  • Publish repository(发布仓库)会出现,因为您尚未将仓库发布到 GitHub,下一个步骤才发布。 工具栏的这部分将根据您当前分支和仓库的状态而改变。 不同的上下文相关操作将可以使用,允许您在本地仓库与远程仓库之间交换数据。

    探索 GitHub Desktop

更改历史记录

在左侧边栏中,您会看到 Changes(更改)History(历史记录)视图。 Changes(更改)和 History(历史记录)选项卡

  • Changes(更改)视图显示您对当前分支中的文件已经做出但尚未提交到本地仓库的更改。 在底部有“Summary(摘要)”和“Description(说明)”文本框,以及 Commit to BRANCH(提交到 [分支])按钮。 这是提交新更改的位置。 Commit to BRANCH(提交到 [分支])按钮是动态的,将显示您提交更改到哪个分支。 提交区域

  • History(历史记录)视图显示仓库当前分支上以前的提交。 您应会看到在创建仓库时 GitHub Desktop 所创建的“初始提交”。 在提交的右侧,根据您在创建仓库时选择的选项,可能会看到 .gitattributes.gitignoreLICENSEREADME 文件。 您可以单击每个文件以查看该文件的差异,也就是提交中对该文件的更改。 差异只显示文件已更改的部分,而不显示文件的全部内容。 历史记录视图

第 4 部分:将仓库推送到 GitHub

创建新仓库时,它仅存在于您的计算机上,您是唯一可以访问该仓库的人。 您可以将仓库发布到 GitHub 以在多台计算机上保持同步,并允许其他人访问它。 要发布仓库,请将本地更改推送到 GitHub。

  1. 单击菜单栏中的 Publish repository(发布仓库)

    发布仓库

    • GitHub Desktop 自动使用创建仓库时输入的信息填充“Name(名称)”和“Description(说明)”字段。
    • Keep this code private(保持此代码为私有)可让您控制谁可以查看您的项目。 如果您不选中此选项,GitHub 上的其他用户将能够查看您的代码。 如果选中此选项,您的代码将不会公开。
    • Organization(组织)下拉菜单(如果有)可让您将仓库发布到 GitHub 上您所属的特定组织。

    发布仓库步骤

  2. 单击 Publish Repository(发布仓库)按钮。

  3. 您可以从 GitHub Desktop 访问 GitHub.com 上的仓库。 在文件菜单中,单击 Repository(仓库),然后单击 View on GitHub(在 GitHub 上查看)。 这会直接在默认浏览器中打开仓库。

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

现在,您已经创建并发布仓库,已经准备好对项目进行更改,并开始创建第一个对仓库的提交。

  1. 要从 GitHub Desktop 启动外部编辑器,请单击 Repository(仓库),然后单击 Open in EDITOR(在 [编辑器] 中打开)。 更多信息请参阅“配置默认编辑器

    在编辑器中打开

  2. 对以前创建的 README.md 文件做一些更改。 您可以添加描述项目的信息,比如它做什么,以及为什么有用。 当您对更改满意时,请将它们保存在文本编辑器中。

  3. 在 GitHub Desktop 中,导航到 Changes(更改)视图。 在文件列表中,您应该会看到 README.mdREADME.md 文件左边的勾选标记表示您对文件的更改将成为提交的一部分。 以后您可能会更改多个文件,但只想提交对其中部分文件所做的更改。 如果单击文件旁边的复选标记,则该文件不会包含在提交中。

    查看更改

  4. Changes(更改)列表底部,输入提交消息。 在头像右侧,键入提交的简短描述。 由于我们在更改 README.md 文件,因此“添加关于项目目的的信息”将是比较好的提交摘要。 在摘要下方,您会看到“Description(说明)”文本字段,在其中可以键入较长的提交更改描述,这有助于回顾项目的历史记录和了解更改的原因。 由于您是对 README.md 文件做基本的更新,因此可跳过描述。

    Commit message
    <<<<<<< HEAD

  5. 单击 Commit to BRANCH NAME(提交到 [分支名称])。 提交按钮显示当前分支,因此您可以确保提交到所需的分支。

    提交到分支

  6. 单击 Commit to master(提交至 master)。 提交按钮显示您当前的分支,在本例中是 master,这样您就知道要提交到哪个分支。

    提交到 master

    master

  7. 要将更改推送到 GitHub 上的远程仓库,请单击 Push origin(推送源)

    推送源

  • Push origin(推送源)按钮就是您单击以发布仓库到 GitHub 的按钮。 此按钮根据 Git 工作流程中的上下文而变。 现在改为 Push origin(推送源)了,其旁边的 1 表示有一个提交尚未推送到 GitHub。
  • Push origin(推送源)中的“源”表示我们将更改推送到名为 origin 的远程,在本例中是 GitHub.com 上的项目仓库。 在推送任何新提交到 GitHub 之前,您的计算机上的项目仓库与 GitHub.com 上的项目仓库之间存在差异。 这可让您在本地工作,并且仅在准备好后才将更改推送到 GitHub.com。
  1. Changes(更改)视图右边的窗口中,您会看到接下来可以执行的操作提示。 要在浏览器中打开 GitHub 上的仓库,请单击 View on GitHub(在 GitHub 中查看)
    可用操作
  2. 在浏览器中,单击 2 commits(2 次提交)。 您会看到 GitHub 上此仓库中的提交列表。 第一个提交应是您刚才在 GitHub Desktop 中的提交。
    单击两个提交

结论

您现已创建一个仓库,并且已将仓库发布到 GitHub,进行了提交,并且已将更改推送到 GitHub。 在参与创建或协作的其他项目时,可以遵循这个相同的工作流程。

延伸阅读

此文档对您有帮助吗?

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。