跳至主要内容

从模板创建仓库

您可以生成一个新仓库,其目录结构和文件与现有仓库相同。

谁可以使用此功能?

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

本文内容

关于仓库模板

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

提示

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

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

从模板创建仓库类似于对仓库进行分叉,但两者存在重要差异

  • 新的分叉包含父仓库的完整提交历史,而从模板创建的仓库只从单次提交开始。
  • 对分叉的提交不会显示在您的贡献图中,而对从模板创建的仓库的提交会显示在您的贡献图中。
  • 分叉可以作为向现有项目临时贡献代码的方式,而从模板创建仓库则能快速启动新项目。

有关分叉的更多信息,请参阅关于分叉

从模板创建仓库

  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. 使用 Owner(所有者)下拉菜单选择您希望拥有该仓库的账户。

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

  5. 为您的仓库输入名称(最多 100 个字符),并可选择添加描述。

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

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

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

  8. 可选:如果您创建所在的个人账户或组织使用了来自 GitHub Marketplace 的任何 GitHub 应用,请选择您希望在仓库中使用的应用。

  9. 单击从模板创建仓库

© . This site is unofficial and not affiliated with GitHub, Inc.