Skip to main content

此版本的 GitHub Enterprise Server 已于以下日期停止服务 2024-07-09. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

GitHub Desktop 使用入门

了解如何设置、验证和配置 GitHub Desktop,以便直接从您的计算机直接参与项目。

Platform navigation

介绍

GitHub Desktop 是免费的开放源代码应用程序,可帮助处理托管在 GitHub 或其他 Git 托管服务上的代码。 使用 GitHub Desktop,可以在图形用户界面中执行提交和推送更改等 Git 命令,而不是使用命令行。 有关详细信息,请参阅“关于 GitHub Desktop”。

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

您可能会发现,在开始使用 GitHub 之前,基本了解 Git 和 GitHub Desktop 会有帮助。 有关详细信息,请参阅以下文章。

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 Enterprise Server 的组织的成员,并且没有帐户,请联系你的 GitHub Enterprise 站点管理员。

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

    Mac 上的菜单栏的屏幕截图。 在打开的“GitHub Desktop”下拉菜单下,光标悬停在“首选项”上,后者呈蓝色突出显示。

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

    “首选项”窗口中的“帐户”窗格的屏幕截图。 在“GitHub.com”旁边,标有“登录”的按钮显示橙色轮廓。

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

  1. 在向 GitHub 或 GitHub Enterprise 进行身份验证之前,你需要一个帐户。如果你是使用 GitHub Enterprise Server 的组织的成员,并且没有帐户,请联系你的 GitHub Enterprise 站点管理员。
  2. 在“文件”下拉菜单中,单击“选项”。 在选项窗口中,单击“帐户”并按照步骤登录。 若要详细了解如何进行身份验证,请参阅“在 GitHub Desktop 中向 GitHub 进行身份验证”。
    “选项”窗口中“帐户”窗格的屏幕截图。 在“GitHub.com”旁边,标有“登录”的按钮显示橙色轮廓。

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

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

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

“首选项”窗口的屏幕截图。 包含“帐户”和“集成”等菜单选项的左侧边栏以橙色轮廓突出显示。

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

“首选项”窗口的屏幕截图。 包含“帐户”和“集成”等菜单选项的左侧边栏以橙色轮廓突出显示。

第 3 部分:通过 GitHub Desktop 参与项目

在安装、验证和配置应用程序后,便可开始使用 GitHub Desktop。 您可以创建、添加或克隆仓库,并使用 GitHub Desktop 来管理对您的仓库的参与。

创建、添加和克隆仓库

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

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

可选择“文件”,然后单击“克隆存储库...”,从 GitHub 克隆存储库。有关详细信息,请参阅“从 GitHub Desktop 克隆和复刻仓库”。

Mac 上的菜单栏的屏幕截图。 存储库的操作在打开的“文件”下拉菜单中列出。

Windows 上的“GitHub Desktop”菜单栏的屏幕截图。 存储库的操作在打开的“文件”下拉菜单中列出。

在分支中更改

您可以使用 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 中同步分支”。