创建存储库

本文内容

若要将项目放在 GitHub 上，需要创建一个存储库来存放它。

Tool navigation

创建存储库

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

注意：

  • 可以为开放源代码项目创建公共存储库。 创建公共存储库时，请确保包含一个许可文件，用于界定你希望与他人共享自己项目的方式。 为深入了解开源，特别是如何创建和发展开源项目，我们制作了开源指南，它将通过推荐关于创建和维护开源项目存储库的最佳实践，帮助你培养一个健康发展的开源社区。
  • 还可以免费学习 GitHub Skills 课程来维护开源社区。
  • 还可以将社区运行状况文件添加到存储库中，以设置有关如何参与、保护存储库安全等的准则。 有关详细信息，请参阅“创建默认的社区运行状况文件”。

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

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

  2. 为存储库键入简短好记的名称。 例如 "hello-world"。

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

  3. 可以选择性地添加存储库的说明。 例如，“我在 GitHub 上的第一个仓库”。

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

  5. 选择“使用 README 初始化此存储库”。

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

恭喜！ 你已经成功创建了第一个存储库，并使用自述文件对其进行了初始化。

若要详细了解 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 手册。

提交您的第一个更改

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

创建新存储库时，你使用自述文件对其进行了初始化。 README 文件用于更详细地描述项目或添加一些指南性文档（例如如何安装或使用项目）。 README 文件的内容会自动显示在存储库的首页上。

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

  1. 在存储库的文件列表中，选择“README.md”。

    存储库中文件列表的屏幕截图。 “README.md”这一文件名以橙色轮廓突出显示。

  2. 在文件视图的右上角，单击 以打开文件编辑器。

文件的屏幕截图。 在标头中，标有铅笔图标的按钮以深橙色标出。

  1. 在文本框中，键入一些关于你自己的信息。

  2. 在新内容的上方，单击“预览”。

    处于编辑模式的文件的屏幕截图。 在文件内容上方，标有“预览”的选项卡以深橙色框出。

  3. 查看您对文件所做的更改。 如果选择“显示差异”，新内容会以绿色显示。

    文件的“预览”视图的屏幕截图。 标记为“显示差异”的复选框已选中，对文件的添加内容由绿线标记指示。 两者都以橙色轮廓显示。

  4. 单击“提交更改...”

  5. 在“提交消息”字段中，输入简短、有意义的提交消息，以描述对文件的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息，请参阅“创建有多个作者的提交”。

  6. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。 有关详细信息，请参阅“创建拉取请求”。

    GitHub 拉取请求的屏幕截图，其中显示了一个单选按钮，用于直接提交到主分支或创建新分支。 已选择“新建分支”。

  7. 单击“提交更改”或“建议更改” 。

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

README 文件用于更详细地描述项目或添加一些指南性文档（例如如何安装或使用项目）。 README 文件的内容会自动显示在存储库的首页上。 按照以下步骤添加一个自述文件。

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

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

    echo "info about this project" >> README.md

  3. 输入 git status。 你会看到你有一个未跟踪的 README.md 文件。

    $ git status

Untracked files:
  (use "git add <file>..." 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 上找到有趣的项目和存储库，并通过创建存储库分支来更改它们。 为存储库创建分支可以在不影响原始存储库的情况下更改另一个存储库。 有关详细信息，请参阅“创建存储库分支”。

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

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