跳至主要内容

从 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. 点击创建别名

进一步阅读