跳至主要内容

从 GitHub Desktop 克隆和派生仓库

您可以使用 GitHub Desktop 克隆和派生 GitHub 上存在的仓库。

平台导航

关于本地仓库

GitHub 上的仓库是远程仓库。您可以使用 GitHub Desktop 克隆或派生仓库,在您的计算机上创建本地仓库。

您可以通过克隆仓库来创建您有权访问的任何 GitHub 仓库的本地副本。如果您拥有仓库或具有写入权限,则可以在本地和远程位置之间同步。有关更多信息,请参阅“在 GitHub Desktop 中同步您的分支”。

当您克隆仓库时,您推送到 GitHub 的任何更改都会影响原始仓库。要进行更改而不影响原始项目,您可以通过派生仓库来创建单独的副本。您可以创建拉取请求,建议维护人员将您派生仓库中的更改合并到原始上游仓库中。有关更多信息,请参阅“关于派生”。

当您尝试使用 GitHub Desktop 克隆您没有写入权限的仓库时,GitHub Desktop 会提示您自动创建派生。您可以选择使用您的派生来为原始上游仓库做出贡献,或者独立地进行自己的项目。任何现有的派生默认情况下都会将更改贡献到其上游仓库。您可以随时修改此选择。有关更多信息,请参阅“管理派生行为”。

您也可以直接从 GitHub 或 GitHub Enterprise 克隆仓库。有关更多信息,请参阅“从 GitHub 克隆仓库到 GitHub Desktop”。

克隆仓库

  1. 在**文件**菜单中,单击**克隆仓库**。

    Screenshot of the menu bar on a Mac. The "File" dropdown menu is expanded, and the "Clone Repository" option is highlighted with an orange outline.

    Screenshot of the "GitHub Desktop" menu bar on Windows. The "File" dropdown menu is expanded, and the "Clone Repository" option is highlighted with an orange outline.

  2. 单击与您要克隆的仓库位置相对应的选项卡。您也可以单击**URL**手动输入仓库位置。

    Screenshot of the "Clone a repository" window. At the top of the window, tabs labeled "GitHub.com", "GitHub Enterprise" and "URL" are highlighted with an orange outline.

  3. 从仓库列表中,单击您要克隆的仓库。

    Screenshot of the "Clone a repository" window. The "github/docs" repository is highlighted with an orange outline.

  4. 要选择要克隆存储库的本地目录,请在“本地路径”字段旁边,单击**选择...**并导航到该目录。

    Screenshot of the "Clone a repository" window. A button, labeled "Choose", is highlighted with an orange outline.

  5. 在“克隆存储库”窗口底部,单击**克隆**。

派生存储库

您可以在 GitHub.com 或 GitHub Desktop 上派生存储库。有关在 GitHub.com 上派生的信息,请参阅“派生存储库”。

在 GitHub Desktop 中,如果您尝试克隆您没有写入权限的存储库,则会自动为您创建一个派生存储库。

  1. 在**文件**菜单中,单击**克隆仓库**。

    Screenshot of the menu bar on a Mac. The "File" dropdown menu is expanded, and the "Clone Repository" option is highlighted with an orange outline.

    Screenshot of the "GitHub Desktop" menu bar on Windows. The "File" dropdown menu is expanded, and the "Clone Repository" option is highlighted with an orange outline.

  2. 单击与您要克隆的仓库位置相对应的选项卡。您也可以单击**URL**手动输入仓库位置。

    Screenshot of the "Clone a repository" window. At the top of the window, tabs labeled "GitHub.com", "GitHub Enterprise" and "URL" are highlighted with an orange outline.

  3. 从仓库列表中,单击您要克隆的仓库。

    Screenshot of the "Clone a repository" window. The "github/docs" repository is highlighted with an orange outline.

  4. 要选择要克隆存储库的本地目录,请在“本地路径”字段旁边,单击**选择...**并导航到该目录。

    Screenshot of the "Clone a repository" window. A button, labeled "Choose", is highlighted with an orange outline.

  5. 在“克隆存储库”窗口底部,单击**克隆**。

  6. 阅读“您打算如何使用此派生存储库?”窗口中的信息。

    • 如果您打算使用此派生存储库来贡献到原始上游存储库,请单击**为父项目贡献**。
    • 如果您打算将此派生存储库用于与上游无关的项目,请单击**用于我自己的目的**。
  7. 单击**继续**。

管理派生存储库行为

您可以在 GitHub Desktop 中更改派生存储库在上游存储库中的行为方式。

  1. 在菜单栏中,选择**存储库**,然后单击**存储库设置...**。

    Screenshot of the menu bar on a Mac. In the expanded "Repository" dropdown menu, a cursor hovers over "Repository Settings", highlighted in blue.

    Screenshot of the "GitHub Desktop" menu bar on Windows. In the open "Repository" dropdown menu, an option labeled "Repository Settings" is outlined in orange.

  2. 在“存储库设置”窗口中,在左侧边栏中,单击**派生存储库行为**。

  3. 在“我将使用此派生存储库...”下,使用单选按钮选择您要如何使用派生存储库。

    Screenshot of the "Fork Behavior" pane. Two radio buttons, labeled "To contribute to the parent repository" and "For my own purposes", are outlined in orange.

  4. 单击**保存**。

为本地存储库创建别名

您可以为本地存储库创建别名,以帮助区分 GitHub Desktop 中同名存储库。创建别名不会影响存储库在 GitHub 上的名称。在存储库列表中,别名以斜体显示。

  1. 在 GitHub Desktop 的左上角,在当前存储库名称的右侧,单击 .
  2. 右键单击要为其创建别名的存储库,然后单击**创建别名**。
  3. 为存储库键入别名。
  4. 单击**创建别名**。

进一步阅读