创建新仓库

您可以在个人帐户或者您有足够权限的任何组织中创建新仓库。

本文内容

Tip

所有者可限制组织中的仓库创建权限。 有关详细信息，请参阅“限制在组织中创建仓库”。

Tip

还可以使用 GitHub CLI 创建存储库。 有关详细信息，请参阅 GitHub CLI 文档中的“gh repo create”。

通过 Web UI 创建新存储库

  1. 在任何页面的右上角，选择 ，然后单击“新建存储库”。

    GitHub 下拉菜单的屏幕截图，其中显示了用于创建新项的选项。 菜单项“新建存储库”用深橙色框标出。

  2. （可选）要使用现有存储库的目录结构和文件创建存储库，请选择“选择模板”下拉菜单，然后单击一个模板存储库。 您将看到由您和您所属组织拥有的模板仓库，或者您以前使用过的模板仓库。 有关详细信息，请参阅“从模板创建仓库”。

  3. （可选）如果选择使用模板，要在模板中包含来自所有分支的目录结构和文件，而不仅仅是默认分支，请选择“包含所有分支”。

  4. 使用“所有者”下拉菜单选择你想要拥有存储库的帐户。

    新 GitHub 存储库的所有者菜单的屏幕截图。 菜单显示两个选项：“octocat”和“github”。

  5. 输入仓库的名称和描述（可选）。

    创建 GitHub 存储库的第一步的屏幕截图。 “存储库名称”字段包含文本“hello-world”，并用深橙色框出。

  6. 选择仓库可见性。 有关详细信息，请参阅“关于仓库”。

  7. 如果您不使用模板，可以使用许多可选项预填充仓库。 如果要将现有仓库导入 GitHub，请不要选择上述任何选项，否则可能会导致合并冲突。 您可以通过用户界面添加或创建新文件，或者选择稍后使用命令行添加新文件。 有关详细信息，请参阅“使用命令行导入外部 Git 存储库”、“添加文件到仓库”和“解决合并冲突”。

    • 您可以创建自述文件以介绍您的项目。 有关详细信息，请参阅“关于自述文件”。
    • 可以创建一个 .gitignore 文件，该文件是一组忽略规则。 有关详细信息，请参阅“忽略文件”
    • 您可以选择为项目添加软件许可。 有关详细信息，请参阅“许可仓库”。

  8. （可选）如果创建的个人帐户或组织使用来自 GitHub Marketplace 的任何 GitHub Apps，请选择要用于存储库中的任何应用程序。

  9. 单击“创建存储库”。

  10. 在生成的 Quick Setup（快速设置）页面底部的“Import code from an old repository（从旧仓库导入代码）”下，您可以选择将项目导入新仓库。 为此，请单击“导入代码”。

通过 URL 查询创建新存储库

创建新存储库时，可以使用查询参数预填充表单域。 查询参数是 URL 中可以定制的部分，用于在 GitHub 上共享特定的网页视图，如搜索过滤结果或议题模板。 若要指定预定义查询参数的值，必须匹配键值对。

如果经常需要创建具有相同默认设置的存储库，使用 URL 查询预先填充表单域可能会很有用。 例如，教师可能需要班级中的每位学生在其个人帐户中创建具有相同名称、描述和可见性的存储库。 使用 URL 查询，教师可以创建一个链接来预先填充存储库名称、描述和可见性字段，并在整个班级共享。

必须具有适当的权限才可执行使用相关查询参数的操作。 例如，必须具有在组织中创建存储库的权限，才能在查询参数中将组织指定为存储库所有者。 有关详细信息，请参阅“组织的存储库角色”。

如果使用查询参数创建无效的 URL，或者如果没有适当的权限，无效的查询参数就会被忽略，其余 URL 将正常工作。 如果创建的 URL 超过服务器限制，URL 将返回 414 URI Too Long 错误页面。

查询参数示例有效值
namehttps://github.com/new?name=test-repo&owner=avocado-corp 创建的是名为“test-repo”的存储库，该存储库归“avocado-corp”组织所有。任何有效的存储库名称。 空格必须替换为 + 或 %20。
descriptionhttps://github.com/new?description=An+exciting+repository&visibility=private&owner=octocat 创建的是描述为“令人兴奋的存储库”，可见性为私密且归 @octocat 所有的存储库。任何字符串。 空格必须替换为 + 或 %20。
visibilityhttps://github.com/new?visibility=private 创建的是可见性为私密的存储库。public
private
ownerhttps://github.com/new?owner=avocado-corp&visibility=public 创建的是归“avocado-corp”组织所有的公共存储库。任何有效的组织名称或用户名。 或者，在登录时使用 @me 将用户帐户指定为所有者。
template_owner 和 template_namehttps://github.com/new?owner=avocado-corp&template_owner=avocado-corp&template_name=octo-repo 创建的是使用 avocado-corp 的模板“octo-repo”的归“avocado-corp”所有的存储库。模板所有者的用户名和存储库模板的名称。

延伸阅读