将项目上传到 GitHub

简介

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

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

如果你已经熟悉 Git，并想了解如何将本地存储的 Git 仓库上传到 GitHub，请参阅将本地托管代码添加到 GitHub。

为你正在进行的每个独立项目创建一个新仓库是个好主意。如果你在编写软件项目，将所有相关文件放入新的仓库中，可让代码库随时间更易于维护和管理。

到目前为止，你在仓库中应该只看到一个文件，即初始化仓库时创建的 README.md 文件。现在，我们将上传你自己的文件。

在页面右侧，选择 Add file（添加文件）下拉菜单。
在下拉菜单中，点击 Upload files（上传文件）。
在电脑上打开存放你的作品的文件夹，然后将所有文件和文件夹拖拽至浏览器中。
在页面底部的 “Commit changes”（提交更改）区域，选择 “Commit directly to the main branch”（直接提交到 main 分支），然后点击 Commit changes（提交更改）。

仓库的 README 文件通常是访问者在打开仓库时看到的第一项内容。它一般包含关于项目内容以及项目为何有用的信息。

正如我们在 Hello World 教程中学到的，README 文件（README.md）采用 Markdown 语法编写。Markdown 是一种易读易写的纯文本格式语言。

在此步骤中，我们将使用 Markdown 编辑项目的 README.md，以便其中包含一些关于项目的基本信息。

在文件列表中，点击 README.md 查看文件。
在文件视图的右上角，点击以打开文件编辑器。
- 你会看到系统已预填了一些项目信息。例如，步骤 1 中填写的仓库名称和描述会显示在第 1 行和第 2 行。
删除除 # 之外的所有文本，然后为你的项目输入一个合适的标题。
- 示例：# About my first project on GitHub。
接下来，添加一些项目相关信息，例如项目目的的描述或主要功能。

注意

如果不知道写什么，可以看看 GitHub 上的其他仓库，了解别人是如何描述他们的项目的。

若要使用更高级的格式，如添加图片、链接和脚注，请参阅基本写作和格式语法。
在新内容上方，点击预览。
查看保存更改后文件的渲染效果，然后切换回 “Edit”（编辑）。
继续编辑并预览文本，直至对 README 内容满意为止。
在右上角，点击 Commit changes（提交更改）。
在弹出的对话框中，已为你预填提交信息（“Update README.md”），且默认已选中 “Commit directly to the main branch”（直接提交到 main 分支）选项。保持这些设置不变，直接点击 Commit changes（提交更改）。

现在，你已经创建了新仓库，上传了一些文件，并添加了项目的 README。

如果将仓库可见性设为 “Public”（公开），仓库将显示在你的个人简介中，你可以将仓库的 URL 分享给他人。

当你在 GitHub 浏览器中直接添加、编辑或删除文件时，GitHub 会记录这些更改（“提交”），从而让你开始管理项目的历史和演变。

在进行更改时，请记住可以从仓库的 main 分支创建新分支，以便在不影响主文件副本的情况下进行实验。然后，当对一系列更改满意后，打开 pull request 将更改合并到 main 分支。有关操作步骤的提醒，请参阅 Hello World。

大多数人希望在本地（即自己的电脑）继续编辑文件，然后不断将这些本地更改同步到 GitHub 上的 “远程”（云端）仓库。有许多工具可以实现此目的，例如 GitHub Desktop。要开始使用，你需要
- Install（安装） GitHub Desktop。欲了解更多信息，请参阅 Getting started with GitHub Desktop（GitHub Desktop 入门指南）。
- Clone（克隆）远程仓库，使其在本机上拥有一份副本。欲了解更多信息，请参阅 Cloning and forking repositories from GitHub Desktop（使用 GitHub Desktop 克隆与分叉仓库）。
- 持续 sync（同步）本地更改到该远程仓库。欲了解更多信息，请参阅 Syncing your branch in GitHub Desktop（在 GitHub Desktop 中同步分支）。
欲了解更多可用于操作 GitHub 托管仓库的工具，请参阅 Connecting to GitHub（连接到 GitHub）。