仓库快速入门

学习如何在 5 分钟内创建新仓库并提交你的第一次更改。

本文内容

创建仓库

GitHub 仓库存储各种项目。在本指南中，你将创建一个仓库并提交你的第一次更改。

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

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

  2. 输入仓库的简短、易记的名称。例如，“hello-world”。

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

  3. 可选：添加仓库的描述。例如，“我在 GitHub 上的第一个仓库”。

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

  5. 选择**使用自述文件初始化此仓库**。

  6. 单击**创建仓库**。

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

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

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

提交您的第一个更改

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

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

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

  1. 在仓库的文件列表中，选择README.md。

    Screenshot of a list of files in a repository. A file name, "README.md", is highlighted with an orange outline.

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

    Screenshot of a file. In the header, a button, labeled with a pencil icon, is outlined in dark orange.

  3. 在文本框中，输入一些关于您的信息。

  4. 在新内容上方，单击**预览**。

    Screenshot of a file in edit mode. Above the file's contents, a tab labeled "Preview" is outlined in dark orange.

  5. 查看您对文件所做的更改。如果您选择**显示差异**，您将看到新内容以绿色显示。

    Screenshot of the "Preview" view for a file. A checkbox labeled "Show diff" is selected, and an addition to the file is indicated by a green line marker. Both are outlined in orange.

  6. 单击**提交更改...**

  7. 在“提交消息”字段中，键入简短、有意义的提交消息，以描述您对文件所做的更改。您可以在提交消息中将提交归属于多个作者。有关更多信息，请参见创建具有多个作者的提交。

  8. 在提交消息字段下方，决定是将您的提交添加到当前分支还是添加到新分支。如果当前分支是默认分支，则应选择为您的提交创建新分支，然后创建拉取请求。有关更多信息，请参见创建拉取请求。

    Screenshot of a GitHub pull request showing a radio button to commit directly to the main branch or to create a new branch. New branch is selected.

  9. 单击**提交更改**或**提出更改**。

现在您已经创建了一个项目，您可以开始提交更改了。

README文件是更详细地描述您的项目或添加一些文档（例如如何安装或使用您的项目）的好地方。您的README文件的内容会自动显示在仓库的首页上。请按照以下步骤添加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 <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

后续步骤

您现在已经创建了一个仓库，其中包括一个README文件，并在GitHub上创建了您的第一个提交。

  • 您现在可以克隆GitHub仓库以在您的计算机上创建本地副本。您可以从本地仓库提交，并创建拉取请求以更新上游仓库中的更改。有关更多信息，请参见克隆仓库和设置Git。

  • 您可以在GitHub上找到有趣的项目和仓库，并通过创建仓库的分支来对其进行更改。创建仓库的分支允许您更改另一个仓库，而不会影响原始仓库。有关更多信息，请参见创建仓库的分支。

  • GitHub上的每个仓库都归个人或组织所有。您可以通过在GitHub上连接和关注他们来与人员、仓库和组织互动。有关更多信息，请参见在GitHub上寻找灵感。

  • GitHub拥有一个强大的支持社区，您可以在其中寻求帮助并与来自世界各地的人们交流。加入GitHub社区的讨论。