{"meta":{"title":"仓库快速入门","intro":"了解如何在 5 分钟内创建新仓库并提交第一个更改。","product":"存储库","breadcrumbs":[{"href":"/zh/repositories","title":"存储库"},{"href":"/zh/repositories/creating-and-managing-repositories","title":"创建和管理存储库"},{"href":"/zh/repositories/creating-and-managing-repositories/quickstart-for-repositories","title":"仓库快速入门"}],"documentType":"article"},"body":"# 仓库快速入门\n\n了解如何在 5 分钟内创建新仓库并提交第一个更改。\n\n## 创建存储库\n\nGitHub 存储库将存储各种项目。 在本指南中，你将创建仓库并提交第一个更改。\n\n<div class=\"ghd-tool webui\">\n\n1. 在任何页面的右上角，选择 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-plus\" aria-label=\"Create something new\" role=\"img\"><path d=\"M7.75 2a.75.75 0 0 1 .75.75V7h4.25a.75.75 0 0 1 0 1.5H8.5v4.25a.75.75 0 0 1-1.5 0V8.5H2.75a.75.75 0 0 1 0-1.5H7V2.75A.75.75 0 0 1 7.75 2Z\"></path></svg>，然后单击“新建存储库”。\n\n   ![GitHub 下拉菜单的屏幕截图，其中显示了用于创建新项的选项。 菜单项“新建存储库”用深橙色框标出。](/assets/images/help/repository/repo-create-global-nav-update.png)\n2. 为存储库键入简短好记的名称。 例如 \"hello-world\"。\n\n   ![创建仓库的第一步的屏幕截图。 “存储库名称”字段包含文本“hello-world”，并用深橙色框出。](/assets/images/help/repository/create-repository-name.png)\n3. 可以选择性地添加存储库的说明。 例如，“我在 GitHub 上的第一个存储库”。\n4. 选择仓库可见性。 有关详细信息，请参阅“[关于仓库](/zh/repositories/creating-and-managing-repositories/about-repositories#about-repository-visibility)”。1. 将 **README** 切换为 **开启**。1. 单击“创建存储库”。\n\n恭喜！ 你已经成功创建了第一个存储库，并使用自述文件对其进行了初始化。\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n> \\[!NOTE]\n> 若要详细了解 GitHub CLI，请参阅“[关于 GitHub CLI](/zh/github-cli/github-cli/about-github-cli)”。\n\n1. 在命令行中，导航到要在其中创建新项目的本地克隆的目录。\n2. 若要为项目创建存储库，请使用 `gh repo create` 子命令。 出现提示时，选择“**从头开始GitHub创建一个新存储库**并输入新项目的名称。 如果希望项目属于某个组织而不是你的个人帐户，请使用 `organization-name/project-name` 指定组织名称和项目名称。\n3. 按照交互式提示进行操作。 要在本地克隆存储库，请在询问您是否要克隆远程项目目录时确认是。\n4. 或者，若要跳过提示，请提供存储库名称和可见性标志（`--public`、`--private` 或 `--internal`）。 例如，`gh repo create project-name --public`。 若要在本地克隆存储库，请传递 `--clone` 标志。 有关可能的参数的详细信息，请参阅 [GitHub CLI 手册](https://cli.github.com/manual/gh_repo_create)。\n\n</div>\n\n## 提交您的第一个更改\n\n<div class=\"ghd-tool webui\">\n\n[提交](/zh/get-started/learning-about-github/github-glossary#commit) 就像是项目中所有文件在特定时间点的快照。\n\n在你创建新存储库时，使用\\_README\\_文件对其进行了初始化。 README 文件用于更详细地描述项目或添加一些指南性文档（例如如何安装或使用项目）。 README 文件的内容会自动显示在存储库的首页上。\n\n让我们提交对 README 文件的更改。\n\n1. 在存储库的文件列表中，选择“README.md”。\n\n![存储库中文件列表的屏幕截图。 “README.md”这一文件名以橙色轮廓突出显示。](/assets/images/help/repository/create-commit-open-readme.png)\n\n1. 在文件视图的右上角，单击 <svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-pencil\" aria-label=\"Edit file\" role=\"img\"><path d=\"M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z\"></path></svg> 以打开文件编辑器。\n   ![文件的屏幕截图。 在标头中，标有铅笔图标的按钮以深橙色标出。](/assets/images/help/repository/edit-file-edit-button.png)\n\n2. 在文本框中，键入一些关于你自己的信息。\n\n3. 在新内容的上方，单击“预览”。\n\n   ![处于编辑模式的文件的屏幕截图。 在文件内容上方，标有“预览”的选项卡以深橙色框出。](/assets/images/help/repository/edit-readme-preview-changes.png)\n\n4. 查看您对文件所做的更改。 如果选择“显示差异”，新内容会以绿色显示。\n\n![文件预览的屏幕截图。 “Show diff”复选框已启用，文件的新增部分以绿色线条显示。 两者都用橙色描边。](/assets/images/help/repository/create-commit-review.png)\n\n1. 单击“提交更改...”\n\n2. 在“提交消息”字段中，输入简短、有意义的提交消息，以描述对文件的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息，请参阅“[创建包含多个作者的提交或代表某个组织创建提交](/zh/pull-requests/how-tos/commit-changes/creating-a-commit-with-multiple-authors)”。\n\n3. 在提交消息字段下面，确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支，则应选择为提交创建新分支，然后创建拉取请求。 有关详细信息，请参阅“[创建拉取请求](/zh/pull-requests/how-tos/create-pull-requests/creating-a-pull-request)”。\n\n   ![GitHub 拉取请求的屏幕截图，其中显示了一个单选按钮，用于直接提交到主分支或创建新分支。 已选择“新建分支”。](/assets/images/help/repository/choose-commit-branch.png)\n\n4. 单击“提交更改”或“建议更改” 。\n\n</div>\n\n<div class=\"ghd-tool cli\">\n\n创建项目后，可以开始提交更改。\n\nREADME 文件用于更详细地描述项目或添加一些指南性文档（例如如何安装或使用项目）。 README 文件的内容会自动显示在存储库的首页上。 按照以下步骤添加一个\\_README\\_文件。\n\n1. 在命令行中，导航到新项目的根目录。 （此目录是在运行 `gh repo create` 命令时创建的。）\n\n2. 创建自述文件，其中包含有关项目的一些信息。\n\n   ```shell\n   echo \"info about this project\" >> README.md\n   ```\n\n3. 输入 `git status`。 你会看到你有一个未跟踪的 `README.md` 文件。\n\n   ```shell\n   $ git status\n\n   Untracked files:\n     (use \"git add <file>...\" to include in what will be committed)\n     README.md\n\n   nothing added to commit but untracked files present (use \"git add\" to track)\n   ```\n\n4. 暂存并提交文件。\n\n   ```shell\n   git add README.md && git commit -m \"Add README\"\n   ```\n\n5. 将更改推送到您的分支。\n\n   ```shell\n   git push --set-upstream origin HEAD\n   ```\n\n</div>\n\n## 后续步骤\n\n你现在已经创建了一个存储库，其中包括一个\\_README\\_文件，并在GitHub上创建了你的第一个提交。\n\n<div class=\"ghd-tool webui\">\n\n* 现在可以克隆 GitHub 存储库以在计算机上创建本地副本。 从您的本地仓库，您可以提交并创建拉取请求来更新上游仓库中的更改。 有关详细信息，请参阅 [克隆仓库](/zh/repositories/creating-and-managing-repositories/cloning-a-repository) 和 [设置 Git](/zh/get-started/git-basics/set-up-git)。\n\n</div>\n\n* 使用 GitHub 的可用安全功能保护存储库。 有关详细信息，请参阅“[保护存储库快速入门](/zh/code-security/getting-started/quickstart-for-securing-your-repository)”。\n\n* 可以在 GitHub 上找到有趣的项目和存储库，并通过创建存储库分支来更改它们。 为存储库创建分支可以在不影响原始存储库的情况下更改另一个存储库。 有关详细信息，请参阅“[为存储库创建分支](/zh/pull-requests/how-tos/work-with-forks/fork-a-repo)”。\n\n* 每个存储库 GitHub 都由个人或组织拥有。 您可以通过在 GitHub 上与这些人员、存储库和组织建立联系并关注它们来与之互动。 有关详细信息，请参阅“[发现GitHub上的项目](/zh/get-started/exploring-projects-on-github/discovering-projects-on-github)”。\n\n* GitHub 有一个强大的支持社区，你可以在那里寻求帮助并与来自世界各地的人交谈。 加入 [GitHub Community](https://github.com/orgs/community/discussions) 上的对话。"}