跳至主要内容

开始使用 GitHub Desktop

了解如何设置、验证和配置 GitHub Desktop,以便直接从计算机为项目做出贡献。

平台导航

简介

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

本指南将通过设置应用程序、验证你的帐户、配置基本设置以及介绍使用 GitHub Desktop 管理项目的基础知识,帮助你开始使用 GitHub Desktop。在完成本指南后,你将能够使用 GitHub Desktop 协作处理项目并连接到远程仓库。

在开始使用 GitHub Desktop 之前,了解 Git 和 GitHub 的基本知识可能会有所帮助。有关更多信息,请参阅以下文章。

GitHub Desktop 是一个开源项目。你可以查看路线图、为项目做出贡献或打开一个议题来提供反馈或功能请求。有关更多信息,请参阅 desktop/desktop 仓库。

第 1 部分:安装和验证

你可以在任何受支持的操作系统上安装 GitHub Desktop。有关更多信息,请参阅“GitHub Desktop 的受支持操作系统”。

要安装 GitHub Desktop,请访问 GitHub Desktop 的下载页面。有关详细信息,请参阅“安装 GitHub Desktop”。

安装 GitHub Desktop 后,可以使用 GitHub 或 GitHub Enterprise 帐户对应用程序进行身份验证。身份验证允许您连接到 GitHub 或 GitHub Enterprise 上的远程存储库。

  1. 在对 GitHub 或 GitHub Enterprise 进行身份验证之前,您需要一个帐户。有关详细信息,请参阅“在 GitHub 上创建帐户”。

  2. 在菜单栏中,选择GitHub Desktop,然后单击首选项

    Screenshot of the menu bar on a Mac. Under the open "GitHub Desktop" dropdown menu, the cursor hovers over "Preferences", which is highlighted in blue.

  3. 在“首选项”窗口中,在帐户窗格上,单击其中一个登录按钮以登录您的 GitHub.com 或 GitHub Enterprise 帐户。

    Screenshot of the "Accounts" pane in the "Preferences" window. Next to "GitHub.com", a button, labeled "Sign In", is outlined in orange.

  4. 按照步骤登录。有关身份验证的详细信息,请参阅“在 GitHub Desktop 中对 GitHub 进行身份验证”。

  1. 在对 GitHub 或 GitHub Enterprise 进行身份验证之前,您需要一个帐户。有关详细信息,请参阅“在 GitHub 上创建帐户”。
  2. 在文件下拉菜单中,单击选项。在选项窗口中,单击帐户并按照步骤登录。有关身份验证的详细信息,请参阅“在 GitHub Desktop 中对 GitHub 进行身份验证”。
    Screenshot of the "Accounts" pane in the "Options" window. Next to "GitHub.com", a button, labeled "Sign In", is outlined in orange.

第 2 部分:配置和自定义 GitHub Desktop

安装 GitHub Desktop 后,您可以配置和自定义该应用程序以最适合您的需求。

您可以在 GitHub 或 GitHub Enterprise 上连接或删除帐户,选择默认文本编辑器或 shell,编辑 Git 配置,更改 GitHub Desktop 的外观,自定义系统对话框,并在 GitHub Desktop 首选项窗口中设置隐私首选项。有关详细信息,请参阅“在 GitHub Desktop 中配置基本设置”。

Screenshot of the "Preferences" window. The left sidebar, with menu options such as "Accounts" and "Integrations", is highlighted with an orange outline.

您可以在 GitHub 或 GitHub Enterprise 上连接或删除帐户,选择默认文本编辑器或 shell,编辑 Git 配置,更改 GitHub Desktop 的外观,自定义系统对话框,并在 GitHub Desktop 选项窗口中设置隐私首选项。有关详细信息,请参阅“在 GitHub Desktop 中配置基本设置”。

Screenshot of the "Preferences" window. The left sidebar, with menu options such as "Accounts" and "Integrations", is highlighted with an orange outline.

第 3 部分:使用 GitHub Desktop 为项目做出贡献

安装、身份验证和配置应用程序后,您就可以开始使用 GitHub Desktop 了。您可以创建、添加或克隆存储库,并使用 GitHub Desktop 管理对存储库的贡献。

创建、添加和克隆存储库

您可以通过在“GitHub Desktop”菜单栏中选择文件并单击新建存储库...来创建新存储库。有关详细信息,请参阅“使用 GitHub Desktop 创建您的第一个存储库”。

您可以通过选择文件并单击添加本地存储库...来从本地计算机添加存储库。有关详细信息,请参阅“将存储库从本地计算机添加到 GitHub Desktop”。

您可以通过选择文件并单击克隆存储库...来从 GitHub 克隆存储库。有关详细信息,请参阅“从 GitHub Desktop 克隆和分叉存储库”。

Screenshot of the menu bar on a Mac. Actions for repositories are listed in the open "File" dropdown menu.

Screenshot of the "GitHub Desktop" menu bar on Windows. Actions for repositories are listed in the open "File" dropdown menu.

在分支中进行更改

您可以使用 GitHub Desktop 创建项目的某个分支。分支将您的开发工作与存储库中的其他分支隔离,以便您可以安全地尝试进行更改。有关详细信息,请参阅“在 GitHub Desktop 中管理分支”。

在对分支进行更改后,您可以在 GitHub Desktop 中查看它们并进行提交以跟踪您的更改。有关详细信息,请参阅“在 GitHub Desktop 中提交和查看对项目的更改”。

如果您希望远程访问您的更改或与其他人共享它们,则可以将您的提交推送到 GitHub。有关详细信息,请参阅“从 GitHub Desktop 将更改推送到 GitHub”。

使用 GitHub Desktop 进行协作

你可以使用 GitHub Desktop 创建问题或拉取请求,与其他人协作处理项目。问题可以帮助你跟踪想法并讨论对项目的可能更改。拉取请求让你可以与他人分享你建议的更改,接收反馈,并将更改合并到项目中。有关更多信息,请参阅“从 GitHub Desktop 创建问题或拉取请求”。

你可以在 GitHub Desktop 中查看你自己的或你的合作者的拉取请求。在 GitHub Desktop 中查看拉取请求让你可以看到任何建议的更改,并可以通过在默认文本编辑器中打开项目的文档和存储库来进行其他更改。有关更多信息,请参阅“在 GitHub Desktop 中查看拉取请求”。

保持本地存储库同步

当你对本地存储库进行更改或其他人对远程存储库进行更改时,你需要将项目的本地副本与远程存储库同步。GitHub Desktop 可以通过推送和拉取提交来保持项目的本地副本与远程版本同步。有关更多信息,请参阅“在 GitHub Desktop 中同步你的分支”。