仓库快速入门

创建存储库

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

为存储库键入简短好记的名称。例如 "hello-world"。
可以选择性地添加存储库的说明。例如，“我在 GitHub 上的第一个存储库”。
选择仓库可见性。有关详细信息，请参阅“关于仓库”。1. 将 README 切换为开启。1. 单击“创建存储库”。

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

注意

若要详细了解 GitHub CLI，请参阅“关于 GitHub CLI”。

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

提交您的第一个更改

          [提交](/get-started/learning-about-github/github-glossary#commit) 就像是项目中所有文件在特定时间点的快照。

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

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

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

       ![存储库中文件列表的屏幕截图。 “README.md”这一文件名以橙色轮廓突出显示。](/assets/images/help/repository/create-commit-open-readme.png)

编辑文件按钮

在文本框中，键入一些关于你自己的信息。数据reusables.files.preview_change %}

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

       ![文件预览的屏幕截图。 “Show diff”复选框已启用，文件的新增部分以绿色线条显示。 两者都用橙色描边。](/assets/images/help/repository/create-commit-review.png)

数据reusables.files.write_commit_message %}数据reusables.files.choose_commit_branch %}数据reusables.files.propose_file_change %}

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

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

在命令行中，导航到新项目的根目录。（此目录是在运行 gh repo create 命令时创建的。）
创建自述文件，其中包含有关项目的一些信息。
```
echo "info about this project" >> README.md
```

输入 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)

暂存并提交文件。

git add README.md && git commit -m "Add README"

将更改推送到您的分支。
```
git push --set-upstream origin HEAD
```

后续步骤

你现在已经创建了一个存储库，其中包括一个_README_文件，并在GitHub上创建了你的第一个提交。

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

使用 GitHub 的可用安全功能保护存储库。有关详细信息，请参阅“保护存储库快速入门”。
可以在 GitHub 上找到有趣的项目和存储库，并通过创建存储库分支来更改它们。数据再利用ables.开始入门.派生一个仓库 %}
GitHub 中的每个仓库均归个人或组织所有。可以在 GitHub 上连接和关注人员、仓库和组织以与之进行交互。有关详细信息，请参阅“在GitHub上寻找灵感”。
GitHub 有一个强大的支持社区，你可以在那里寻求帮助并与来自世界各地的人交谈。加入 GitHub Community 上的对话。

Tool navigation

在本文中

创建存储库

提交您的第一个更改

后续步骤