GitHub仓库快速入门：从创建到提交第一个更改

GitHub仓库快速入门：从创建到提交第一个更改

引用

github

1.

https://docs.github.com/zh/repositories/creating-and-managing-repositories/quickstart-for-repositories

本文将带你快速入门GitHub仓库的创建和管理。通过本文，你将学会如何创建一个新的存储库、提交第一个更改，并了解后续的操作步骤。

创建存储库

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

1. 在GitHub网站的任何页面右上角，选择“+”图标，然后单击“新建存储库”。

2. 为存储库键入简短好记的名称。例如 "hello-world"。
3. 可选择性地添加存储库的说明。例如，“我在GitHub上的第一个仓库”。
4. 选择仓库可见性。有关详细信息，请参阅“关于仓库”。
5. 选择“使用README初始化此存储库”。
6. 单击“创建存储库”。

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

使用GitHub CLI创建存储库

若要详细了解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”。
2. 在文件视图的右上角，单击以打开文件编辑器。
3. 在文本框中，键入一些关于你自己的信息。
4. 在新内容的上方，单击“预览”。
5. 查看您对文件所做的更改。如果选择“显示差异”，新内容会以绿色显示。
6. 单击“提交更改...”
7. 在“提交消息”字段中，输入简短、有意义的提交消息，以描述对文件的更改。您可以在提交消息中将提交归于多个作者。有关详细信息，请参阅“创建有多个作者的提交”。
8. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。有关详细信息，请参阅“创建拉取请求”。
9. 单击“提交更改”或“建议更改”。

使用命令行提交更改

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上创建了你的第一个提交。现在可以：

• 克隆GitHub存储库以在计算机上创建本地副本。从您的本地仓库，您可以提交并创建拉取请求来更新上游仓库中的更改。有关详细信息，请参阅克隆仓库和Set up Git。