跳至主要内容

从模板创建仓库

您可以使用与现有仓库相同的目录结构和文件生成新仓库。

谁可以使用此功能?

任何拥有模板仓库读取权限的人都可以从此模板创建仓库。

关于仓库模板

您可以从现有仓库创建模板。任何拥有模板仓库访问权限的人都可以基于该模板创建一个新的仓库,该仓库具有相同的目录结构、分支和文件。有关创建仓库模板的更多信息,请参阅“创建模板仓库”。

提示

您也可以使用 GitHub CLI 从模板创建仓库。更多信息,请参阅 GitHub CLI 文档中的“gh repo create”。

您可以选择仅包含模板仓库默认分支中的目录结构和文件,也可以包含所有分支。从模板创建的分支具有不相关的历史记录,这意味着您无法在这些分支之间创建拉取请求或合并。

从模板创建仓库类似于派生仓库,但有一些重要的区别

  • 新的派生仓库包含父仓库的完整提交历史记录,而从模板创建的仓库则从单个提交开始。
  • 派生仓库的提交不会出现在您的贡献图中,而从模板创建的仓库的提交则会出现在您的贡献图中。
  • 派生仓库可以作为向现有项目贡献代码的临时方式,而从模板创建仓库则可以快速启动新项目。

有关派生的更多信息,请参阅“关于派生”。

从模板创建仓库

  1. 在 GitHub 上,导航到仓库的主页。

  2. 在文件列表上方,单击**使用此模板**。

  3. 选择**创建新的仓库**。

    Screenshot of the "Use this template" button and the dropdown menu expanded to show the "Open in a codespace" option.

    注意

    或者,您可以在 codespace 中打开模板,稍后将您的工作发布到新的仓库。更多信息,请参阅“从模板创建 codespace”。

  4. 使用**所有者**下拉菜单选择您希望拥有该仓库的帐户。

    Screenshot of the owner menu for a new GitHub repository. The menu shows two options, octocat and github.

  5. 为您的仓库键入名称和可选说明。

    Screenshot of a the first step in creating a GitHub repository. The "Repository name" field contains the text "hello-world" and is outlined in dark orange.

  6. 选择仓库可见性。更多信息,请参阅“关于仓库”。

  7. 可选:要包含模板中所有分支的目录结构和文件(而不仅仅是默认分支),请选择**包含所有分支**。

  8. 可选:如果您正在创建的个人帐户或组织使用来自 GitHub Marketplace 的任何 GitHub Apps,请选择您想在仓库中使用的任何 Apps。

  9. 单击**从模板创建仓库**。