Skip to main content

创建仓库

要将项目放在 GitHub 上,您需要创建一个仓库来存放它。

创建仓库

您可以在 GitHub 仓库中存储各种项目,包括开源项目。 通过开源项目,您可以共享代码以开发更好、更可靠的软件。 您可以使用仓库与他人协作并跟踪您的工作。 更多信息请参阅“关于仓库”。 要了解有关开源项目的更多信息,请访问 OpenSource.org

注意:

  • 您可以为开源项目创建公共仓库。 创建公共仓库时,请确保包含许可文件以确定您希望与其他人共享项目。 为深入了解开源,特别是如何创建和发展开源项目,我们制作了开源指南,它将推荐关于创建和维护开源项目仓库的最佳实践,帮助您培养一个健康发展的开源社区。
  • 您还可以免费学习关于维护开源社区的 GitHub 技能 课程。
  • 您还可以将社区健康文件添加到存储库,以设置有关如何贡献、确保存储库安全等的准则。 更多信息请参阅“创建默认社区健康文件”。
  1. 在任何页面的右上角,使用 下拉菜单选择 New repository(新建仓库)带有创建新仓库选项的下拉菜单
  2. 为仓库键入简短、令人难忘的名称。 例如 "hello-world"。 用于输入仓库名称的字段
  3. (可选)添加仓库的说明。 例如,“我在 GitHub Enterprise Cloud 上的第一个仓库”。 用于输入仓库说明的字段
  4. 选择仓库可见性。 更多信息请参阅“关于仓库”。 选择仓库可见性的单选按钮
  5. 选择 Initialize this repository with a README(使用自述文件初始化此仓库)使用自述文件初始化此仓库复选框
  6. 单击 Create repository(创建仓库)创建仓库的按钮

恭喜! 您已成功创建第一个仓库,并使用自述文件对其进行了初始化。

要了解有关 GitHub CLI 的更多信息,请参阅“关于 GitHub CLI”。

  1. 在命令行中,导航到要在其中创建新项目的本地克隆的目录。
  2. 要为项目创建存储库,请使用 gh repo create 子命令。 出现提示时,选择从头开始在 GitHub 上创建新存储库 ,然后输入新项目的名称。 如果希望项目属于某个组织而不是您的个人帐户,请使用 organization-name/project-name 指定组织名称和项目名称。
  3. 按照交互式提示进行操作。 要在本地克隆存储库,请在询问您是否要克隆远程项目目录时确认是。
  4. 或者,要跳过提示,请提供存储库名称和可见性标志(--public--private--internal)。 例如 gh repo create project-name --public。 要在本地克隆存储库,请传递 --clone 标志。 有关可能的参数的详细信息,请参阅 GitHub CLI 手册

提交您的第一个更改

A 提交就像是项目中所有文件在特定时间点的快照。

创建新仓库时,您使用自述文件对其进行了初始化。 自述文件是详细介绍项目的好工具,您也可以添加一些文档,例如介绍如何安装或使用项目的文档。 自述文件的内容自动显示在仓库的首页上。

让我们提交对自述文件的更改。

  1. 在仓库的文件列表中,单击 README.md文件列表中的自述文件
  2. 在文件内容的上方,单击
  3. Edit file(编辑文件)选项卡上,键入一些关于您自己的信息。 文件中的新内容
  4. 在新内容上方,单击 Preview changes(预览更改)文件预览按钮
  5. 查看您对文件所做的更改。 您将看到绿色的新内容。 文件预览视图
  6. 在页面底部,输入一条简短、有意义的提交消息,描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 更多信息请参阅“创建有多个合作作者的提交”。 有关更改的提交消息
  7. 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支,则应选择为提交创建新分支,然后创建拉取请求。 更多信息请参阅“创建新的拉取请求”。 提交分支选项
  8. 单击 Propose file change(提议文件更改)提议文件更改按钮

创建项目后,可以开始提交更改。

自述文件是详细介绍项目的好工具,您也可以添加一些文档,例如介绍如何安装或使用项目的文档。 自述文件的内容自动显示在仓库的首页上。 请按照以下步骤添加 README 文件。

  1. 在命令行中,导航到新项目的根目录。 (此目录是在运行 gh repo create 命令时创建的。)

  2. 创建 README 文件,其中包含有关项目的一些信息。

    echo "info about this project" >> README.md
  3. 输入 git status。 您将看到您有一个未跟踪的 README.md 文件。

    $ git status
    
    Untracked files:
      (use "git add ..." to include in what will be committed)
      README.md
    
    nothing added to commit but untracked files present (use "git add" to track)
  4. 暂存并提交文件。

    git add README.md && git commit -m "Add README"
  5. 将更改推送到您的分支。

    git push --set-upstream origin HEAD

后续步骤

您现在已经创建了一个仓库,其中包括自述文件,并在 GitHub.com 上创建了您的第一个提交。

  • 您现在可以克隆 GitHub 仓库以在计算机上创建本地副本。 从您的本地仓库,您可以提交并创建拉取请求来更新上游仓库中的更改。 更多信息请参阅“克隆仓库”和“设置 Git”。
  • 您可以在 GitHub 上找到有趣的项目和仓库,并通过创建仓库的复刻来更改它们。 Forking a repository will allow you to make changes to another repository without affecting the original. 更多信息请参阅“复刻仓库”。

  • GitHub 中的每个仓库均归个人或组织所有。 您可以在 GitHub Enterprise Cloud 上连接和关注人员、仓库和组织以与之进行交互。 更多信息请参阅“社交”。

  • GitHub 有一个强大的支持社区,您可以在那里寻求帮助并与来自世界各地的人交谈。 加入 GitHub 支持社区的对话。