创建新存储库

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

本文内容

提示：所有者可以限制组织中的存储库创建权限。有关详细信息，请参阅“限制组织中的存储库创建”。

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

从 Web UI 创建新存储库

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

    Screenshot of a GitHub dropdown menu showing options to create new items. The menu item "New repository" is outlined in dark orange.

  2. 或者，要使用现有存储库的目录结构和文件创建存储库，请选择选择模板下拉菜单并单击模板存储库。您将看到您拥有或您是其成员或您之前使用过的组织所拥有的模板存储库。有关详细信息，请参阅“从模板创建存储库”。

  3. 或者，如果您选择使用模板，要包括模板中所有分支的目录结构和文件，而不仅仅是默认分支，请选择包括所有分支。

  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. 如果您不使用模板，则可以预先填充一些可选项目到您的存储库中。如果您要将现有存储库导入到 GitHub，请不要选择任何这些选项，因为您可能会引入合并冲突。您可以使用用户界面添加或创建新文件，也可以选择稍后使用命令行添加新文件。有关详细信息，请参阅“使用命令行导入外部 Git 存储库”、“将文件添加到存储库”和“解决合并冲突”。

    • 您可以创建一个 README，这是一个描述您项目的文档。有关详细信息，请参阅“关于 README”。
    • 您可以创建一个 .gitignore 文件，这是一组忽略规则。有关详细信息，请参阅“忽略文件”。
    • 您可以选择为您的项目添加一个软件许可证。有关详细信息，请参阅“许可存储库”。

  8. 或者，如果您要创建的个人帐户或组织在 GitHub Marketplace 中使用任何 GitHub 应用，请选择您希望在存储库中使用的任何应用。

  9. 单击创建存储库。

  10. 在生成的快速设置页面的底部，“从旧存储库导入代码”下，您可以选择将项目导入到您的新存储库中。要执行此操作，请单击导入代码。

从 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 创建一个描述为“An exciting repository”的存储库，由 @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”拥有的存储库，使用 avocado-corp 的模板“octo-repo”。模板所有者的用户名和存储库模板的名称。

延伸阅读