跳至主要内容

从模板创建仓库

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

谁可以使用此功能?

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

关于仓库模板

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

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

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

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

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

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

从模板创建仓库

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

  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 应用,请选择您想在仓库中使用的任何应用。

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