简介
本教程介绍如何将一组文件上传到 GitHub 存储库。
通过将文件上传到 GitHub 存储库，你可以：
- 在对文件进行编辑时应用版本控制，以便你的项目历史记录受到保护且易于管理。
- 备份你的工作，因为你的文件现在存储在云端。
- 将存储库固定到个人主页，以便其他人可以看到你的项目。
- 公开或私下与他人共享和讨论你的工作。
如果你已经熟悉 Git，并且正在寻找有关如何将本地存储的 Git 存储库上传到 GitHub 的信息，请参阅 将本地托管代码添加到 GitHub。
先决条件
- 你必须拥有 GitHub 帐户。 有关更多信息，请参阅 在 GitHub 上创建帐户。
- 你应该有一组要上传的文件。
步骤 1：为项目创建新存储库
最好为正在处理的每个项目创建一个新存储库。 如果你正在编写一个软件项目，将所有相关文件分组到一个新存储库中可以更轻松地维护和管理随着时间的推移而变化的代码库。
-
在任何页面的右上角，选择 ，然后单击“新建存储库”。
-
在“存储库名称”框中，键入你的项目的名称。 例如，键入“my-first-project”。
-
在“说明”框中，键入简短说明。例如，键入“这是我GitHub上的第一个项目”。
-
选择存储库是“公共”还是“专用” 。 如果希望其他人能够看到项目，请选择“公开”。
-
选择“添加 README 文件”。 你将在后面的步骤中编辑此文件。
-
单击“创建存储库”。
步骤 2：将文件上传到项目的存储库
到目前为止，你应该只看到存储库中列出一个文件，即初始化存储库时创建的 README.md 文件。 现在，我们将上传你自己的一些文件。
- 在页面右侧，选择“ 添加文件”下拉菜单。
- 在下拉菜单中，单击“上传文件”。
- 在计算机上，打开包含工作的文件夹，然后将所有文件和文件夹拖放到浏览器中。
- 在页面底部的“提交更改”下，选择“直接提交到
main分支”，然后单击“提交更改”。
步骤 3：编辑项目存储库的 README 文件
存储库的自述文件通常是访问存储库时某人将看到的第一个项目。 它通常包含有关项目的内容以及你的项目为何有用的信息。
正如我们在 Hello World 教程中学到的，README 文件 (README.md) 是用 Markdown 语法编写的。 Markdown 是一种易于读取和编写的语言，用于设置纯文本格式。
在此步骤中，我们将使用 Markdown 编辑项目的 README.md，以便它包含有关项目的一些基本信息。
-
在文件列表中，单击
README.md以查看文件。 -
在文件视图的右上角，单击 以打开文件编辑器。
- 你将看到系统已预先填充有关项目的某些信息。 例如，你应该在第 1 行和第 2 行看到步骤 1 中填写的存储库名称和存储库描述。
-
删除除
#之外的现有文本，然后键入项目的适当标题。- 示例：
# About my first project on GitHub。
- 示例：
-
接下来，添加一些有关项目的信息，例如项目用途或其主要功能的说明。
-
在新内容的上方，单击“预览”。
-
保存更改后，查看文件将如何呈现，然后切换回“编辑”。
-
继续编辑和预览文本，直到对自述文件的内容感到满意为止。
-
在右上角，单击“提交更改”。
-
在打开的对话框中，已为你预先填写了提交消息（“更新 README.md”），并且默认情况下已选择“直接提交到
main分支”选项。 保留这些选项，然后继续单击“提交更改”。
结束语
你现在已经创建了一个新存储库，向其中上传了一些文件，并添加了项目 README 文件。
如果将存储库可见性设置为“公开”，则存储库将显示在你的个人资料中，并且你可以与其他人共享存储库的 URL。
直接在 GitHub 上的浏览器中添加、编辑或删除文件时，GitHub 将跟踪这些更改（“提交”），以便可以开始管理的项目的历史记录和演变。
进行更改时，请记住，可以从存储库的 main 分支创建新分支，以便无需影响文件的主副本即可进行试验。 然后，当你对一组更改感到满意时，请打开一个拉取请求，将更改合并到 main 分支中。 有关如何执行此操作的提醒，请参阅 Hello World。
后续步骤
-
大多数人希望在本地（即在其自己的计算机上）继续处理文件，然后将这些本地所做的更改与 GitHub 上的此“远程”（在云中）存储库同步。 有许多工具可让你执行此作，例如GitHub桌面。 需要满足以下先决条件才能开始使用：
- Install GitHub Desktop。 有关详细信息，请参阅“GitHub Desktop 使用入门”。
- 克隆远程存储库，以便在自己的计算机上拥有该存储库的副本。 有关详细信息，请参阅“从 GitHub Desktop 克隆和派生存储库”。
- 将本地更改与此远程版本库持续同步。 有关详细信息，请参阅“在 GitHub Desktop 中同步分支”。
-
要详细了解可用于处理 GitHub 上托管的存储库的其他工具，请参阅 连接到 GitHub。