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