跳至主要内容

仓库快速入门

学习如何在 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社区的讨论。