跳至主要内容

从 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 或 GitHub Desktop 中派生存储库。有关在 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. 在“克隆存储库”窗口的底部,单击“克隆”。

  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. 单击“创建别名”。

进一步阅读