简介
GitHub 是一款基于 Web 的应用程序,允许您在仓库中托管文件、协作处理工作以及跟踪文件随时间的更改。GitHub 上的版本跟踪由开源软件 Git 提供支持。每当您更新 GitHub 上的仓库时,Git 都会跟踪您所做的更改。
有多种方法可以与 GitHub 协作,您可以选择一种适合您的经验水平、个人偏好以及您所使用仓库的方法。例如,您可以选择是在浏览器中工作还是在桌面上工作,如何使用 Git,以及您对编辑器和其他软件需要哪些功能。您可以选择以不同的方式处理不同的仓库。
如果您是 GitHub 新手,一个良好的开始贡献方式是在 GitHub.com 的浏览器中进行更改。随着您对 GitHub 越来越熟悉并开始贡献更大的更改,您可能希望开始使用其他工具。本文介绍了如何逐步完成这些阶段,并帮助您在每个阶段选择最符合您需求的工具。要快速比较可用于连接 GitHub 的所有工具,请参阅“连接 GitHub 的工具比较”。
入门
在 GitHub.com 上的用户界面中,您可以执行贡献到代码库的整个“GitHub 工作流”,包括创建分支或 fork、编辑和预览文件、提交更改以及创建拉取请求。您还可以从计算机上传文件或从代码库下载文件。有关更多信息,请参阅“GitHub 工作流”。
直接在 GitHub.com 上工作通常是贡献到代码库的最快方式,原因如下。
- 您直接使用托管在 GitHub 上的代码库,因此您无需将代码库的副本下载到您的计算机上,也无需保持此副本的同步。
- 如果您已登录 GitHub,则可以访问您拥有必要权限的任何代码库,因此您无需在计算机上设置任何其他身份验证。
- 您可以在用户界面中提交更改,因此您无需使用命令行或记住任何 Git 命令。
有关帮助您开始在浏览器中进行更改的教程,请参阅“Hello World”。
在浏览器中进行更复杂的更改
直接在 GitHub.com 上工作最适合小型、简单的更改,通常针对代码库中的单个文件。如果您想在浏览器中工作但需要进行更复杂的更改,例如在文件之间移动内容,您可以选择以下工具在专用编辑器中打开代码库。
- 如果您需要一个可以快速打开或创建文件的编辑器,您可以在任何代码库中按
.
键以打开 github.dev 编辑器。这是一个轻量级的基于 Web 的编辑器,包含 Visual Studio Code 的许多功能,例如搜索栏和 Git 命令按钮。有关更多信息,请参阅“基于 Web 的 github.dev 编辑器”。 - 如果您想留在浏览器中,但需要执行运行命令、创建项目的测试版本或安装依赖项等操作,则可以在 Codespace 中打开代码库。Codespace 是一个具有存储和计算能力的远程开发环境。它包括一个编辑器和集成终端,并且预装了您可能需要用于处理项目(包括 Git)的常用工具。有关更多信息,请参阅“GitHub Codespaces 概述”。
或者,您可以从桌面连接到 GitHub,并使用代码库的本地副本。
从桌面工作
要从桌面使用代码库,您需要将代码库的副本下载(或“克隆”)到您的计算机上,然后将您所做的任何更改推送到 GitHub。与在浏览器中工作相比,从桌面工作可能具有以下几个优势。
- 您可以使用所有本地文件和工具。
- 您可以访问计算能力。例如,您可能需要运行脚本以创建站点的本地预览,以便您可以测试您正在进行的更改。
- 您无需互联网连接即可处理项目。
如果您以前从未从桌面使用过 GitHub 代码库,则需要从您的计算机对 GitHub 进行身份验证,以便您可以访问所需的代码库。您可能还需要使用所需的工具设置工作环境,例如 Git、编辑器和项目的依赖项。由于这些原因,如果您想从桌面工作,与在浏览器中工作相比,入门可能需要更长时间。
您可以使用多种工具从桌面连接到 GitHub。这些工具允许您对 GitHub 进行身份验证、克隆代码库、跟踪更改并将更改推送到 GitHub。
- 如果您需要很多控制权和灵活性,可以使用命令行。您需要安装 Git 并熟悉一些基本的 Git 命令。您还可以安装 GitHub CLI,这是一种命令行界面,允许您在 GitHub 上执行许多操作,例如创建拉取请求或 fork 代码库。有关更多信息,请参阅“设置 Git”和“关于 GitHub CLI”。
- 如果您更喜欢使用可视化界面,则可以使用可视化 Git 客户端,例如 GitHub Desktop。使用 GitHub Desktop,您可以可视化您正在进行的更改,并通过可视化界面访问大多数 Git 命令,因此您无需记住任何命令。有关更多信息,请参阅“关于 GitHub Desktop”。
- 如果您想在一个地方工作,通常可以在您的编辑器中完成大部分操作。诸如 VS Code 之类的编辑器包括一个集成终端和用于常用 Git 命令的按钮,因此您可以从一个地方编辑文件并将更改推送到 GitHub。您还可以安装扩展程序以直接使用 GitHub 上的拉取请求和问题。要开始使用,请参阅 下载 VS Code。
连接 GitHub 的工具比较
下表比较了您可以用于处理 GitHub 上代码库的工具,包括在浏览器中和从桌面上。
您可以使用此处描述的任何工具执行整个 GitHub 工作流。每个工具不仅提供用于跟踪您所做更改的 Git 命令,还提供 GitHub 特定的功能,因此您可以从您正在工作的任何位置创建包含您建议更改的拉取请求。
有关如何使用这些工具中的每一个对 GitHub 进行身份验证的更多信息,请参阅“关于对 GitHub 进行身份验证”。
工具 | 用例 | 浏览器或桌面 |
---|---|---|
在 GitHub.com 上 | 您需要一个可视化界面,并且需要进行快速、简单的更改,通常涉及单个提交。有关介绍,请参阅“Hello World”。 | 浏览器 |
github.dev | 您需要对代码库进行比 GitHub.com 上更复杂的更改,但无需使用终端或您计算机上安装的工具。有关更多信息,请参阅“基于 Web 的 github.dev 编辑器”。 | 浏览器 |
GitHub Codespaces | 您需要计算机的资源来执行运行脚本、创建项目的测试版本或安装依赖项等操作,并且您希望通过在基于云的环境中工作来快速入门。有关更多信息,请参阅“GitHub Codespaces 概述”。 | 浏览器或桌面 |
GitHub Desktop | 您希望在本地处理文件,并且更喜欢使用可视化界面来使用 Git、可视化更改并与 GitHub 交互。有关更多信息,请参阅“关于 GitHub Desktop”。 | 桌面 |
IDE 或文本编辑器 | 您正在处理更复杂的文件和项目,并且希望所有内容都位于一个地方。 | 桌面 |
命令行 Git 和 GitHub CLI | 您习惯于从命令行工作,并且希望避免切换上下文,或者您需要访问未集成到可视化界面中的复杂 Git 命令。有关更多信息,请参阅“设置 Git”和“关于 GitHub CLI”。 | 桌面 |
GitHub API | 您希望自动化备份数据等常见任务,或创建扩展 GitHub 的集成。有关更多信息,请参阅“比较 GitHub 的 REST API 和 GraphQL API”。 | 浏览器或桌面 |
进一步阅读
- “关于 Git”