跳至主要内容

将项目上传到 GitHub

了解如何将项目文件上传到 GitHub。

简介

本教程将向您展示如何将一组文件上传到 GitHub 仓库。

将文件上传到 GitHub 仓库可以让您

  • 应用版本控制,以便在您对文件进行编辑时,项目的历史记录得到保护和管理。
  • 备份您的工作,因为您的文件现在存储在云端。
  • 固定仓库到您的个人资料,以便其他人可以看到您的工作。
  • 分享和讨论您的工作,可以公开或私下进行。

如果您已经熟悉 Git,并且正在寻找有关如何将本地存储的 Git 仓库上传到 GitHub 的信息,请参阅“将本地托管的代码添加到 GitHub”。

先决条件

  • 您需要拥有一个 GitHub 帐户。有关更多信息,请参阅“在 GitHub 上创建帐户”。
  • 您应该有一组要上传的文件。

步骤 1:为您的项目创建一个新的仓库

为每个正在进行的项目创建一个新的仓库是一个好主意。如果您正在编写软件项目,将所有相关文件分组到一个新的仓库中,可以更轻松地维护和管理代码库。

  1. 在任何页面的右上角,选择 ,然后单击新建仓库

    Screenshot of a GitHub dropdown menu showing options to create new items. The menu item "New repository" is outlined in dark orange.

  2. 在“仓库名称”框中,输入项目的名称。例如,输入“my-first-project”。

  3. 在“描述”框中,输入简短的描述。例如,输入“这是我在 GitHub 上的第一个项目”。

  4. 选择您的仓库是公开还是私有。如果您希望其他人能够看到您的项目,请选择“公开”。

  5. 选择添加 README 文件。您将在后面的步骤中编辑此文件。

  6. 单击创建仓库

步骤 2:将文件上传到项目的仓库

到目前为止,您应该只看到仓库中列出了一个文件,即您在初始化仓库时创建的README.md文件。现在,我们将上传您的一些文件。

  1. 在页面右侧,选择添加文件下拉菜单。
  2. 从下拉菜单中,单击上传文件
  3. 在您的计算机上,打开包含您工作的文件夹,然后将所有文件和文件夹拖放到浏览器中。
  4. 在页面底部,“提交更改”下,选择“直接提交到main分支”,然后单击提交更改

步骤 3:编辑项目仓库的 README 文件

仓库的 README 文件通常是访问您的仓库时人们看到的第一个项目。它通常包含有关您的项目是什么以及您的项目为什么有用的信息。

正如我们在“Hello World”教程中了解到的那样,README 文件(README.md)是用 Markdown 语法编写的。Markdown 是一种易于阅读、易于编写的用于格式化纯文本的语言。

在本步骤中,我们将使用 Markdown 编辑项目的 README.md 文件,使其包含有关项目的一些基本信息。

  1. 在文件列表中,点击 README.md 查看文件。

  2. 在文件视图的右上角,点击 打开文件编辑器。

    • 您将看到一些有关项目的信息已为您预先填写。例如,您应该在第 1 行和第 2 行看到在步骤 1 中完成的仓库名称和仓库描述。
  3. 删除除 # 之外的现有文本,然后为您的项目输入一个合适的标题。

    • 例如:# 关于我在 GitHub 上的第一个项目
  4. 接下来,添加一些有关项目的信息,例如项目目的的描述或其主要功能。

    注意:如果您不确定要写什么,请查看 GitHub 上的其他仓库,了解其他人如何描述他们的项目。

    要应用更复杂的格式,例如添加图像、链接和脚注,请参阅 "基本写作和格式语法."

  5. 在新内容上方,点击预览

    Screenshot of a file in edit mode. Above the file's contents, a tab labeled "Preview" is outlined in dark orange.

  6. 查看保存更改后文件将如何呈现,然后切换回“编辑”。

  7. 继续编辑和预览文本,直到您对 README 的内容满意为止。

  8. 在右上角,点击提交更改

  9. 在打开的对话框中,提交消息已为您预先填写(“更新 README.md”),并且默认情况下,已选择“直接提交到 main 分支”选项。保留这些选项,然后点击提交更改

结论

您现在已创建了一个新的仓库,向其中上传了一些文件,并添加了一个项目 README。

如果您将仓库可见性设置为“公开”,则该仓库将显示在您的个人资料中,您可以与他人分享仓库的 URL。

当您直接在 GitHub 上的浏览器中添加、编辑或删除文件时,GitHub 会跟踪这些更改(“提交”),因此您可以开始管理项目的历史记录和演变。

进行更改时,请记住您可以从仓库的 main 分支创建新的分支,以便您可以进行实验而不会影响文件的 اصلی副本。然后,当您对一组更改感到满意时,打开一个拉取请求将更改合并到您的 main 分支中。有关如何执行此操作的提醒,请参阅 "Hello World."

下一步

  • 大多数人希望在本地(即在自己的计算机上)继续处理文件,然后不断将这些本地进行的更改与 GitHub 上的这个“远程”(在云中)仓库同步。有很多工具可以让你做到这一点,比如 GitHub Desktop。要开始使用,您需要

  • 要了解有关用于处理托管在 GitHub 上的仓库的其他工具的更多信息,请参阅“连接到 GitHub”。

进一步阅读