简介
GitHub 是一个基于 Web 的应用程序,允许您在仓库中托管文件、协作工作并随时间跟踪文件的更改。GitHub 上的版本跟踪由开源软件 Git 提供支持。每当您在 GitHub 上更新仓库时,Git 都会跟踪您所做的更改。
可以使用多种方式与 GitHub 协作,您可以根据自己的经验水平、个人偏好以及所使用的仓库选择最合适的方法。例如,您可以决定是使用浏览器还是桌面进行工作,如何使用 Git,以及编辑器和其他软件需要具备哪些功能。不同的仓库也可以采用不同的工作方式。
如果您是 GitHub 新手,开始贡献的一个好方法是直接在 GitHub.com 的浏览器界面上进行更改。随着您对 GitHub 越来越熟悉并开始贡献更大的改动,您可能会想使用其他工具。本文阐述了如何在这些阶段逐步推进,并帮助您在每个阶段选择最适合的工具。要快速比较所有可用于 GitHub 的工具,请参阅 连接 GitHub 的工具比较。
入门指南
在 GitHub.com 的用户界面中,您可以完成完整的 “GitHub flow” 以对仓库做贡献,包括创建分支或 fork、编辑和预览文件、提交更改以及创建拉取请求。您还可以从电脑上传文件或从仓库下载文件。更多信息,请参阅 GitHub flow。
直接在 GitHub.com 上工作往往是对仓库作出贡献的最快方式,原因如下。
- 您直接操作托管在 GitHub 上的仓库,无需将仓库复制到本地并保持同步。
- 如果您已登录 GitHub,则可以访问所有拥有相应权限的仓库,无需在电脑上额外设置身份验证。
- 您可以在用户界面中提交更改,无需使用命令行或记忆任何 Git 命令。
想要快速上手在浏览器中进行更改的教程,请参阅 你好,世界。
在浏览器中进行更复杂的更改
直接在 GitHub.com 上工作最适合小而简单的更改,通常针对仓库中的单个文件。如果您想在浏览器中工作但需要进行更复杂的更改(例如在文件之间移动内容),可以选择以下工具在专用编辑器中打开仓库。
- 如果您希望拥有一个可以快速打开或创建文件的编辑器,只需在任意仓库中按下
.键即可打开 github.dev 编辑器。这是一个轻量级的基于 Web 的编辑器,具备 Visual Studio Code 的许多功能,例如搜索栏和 Git 命令按钮。更多信息,请参阅 github.dev 基于 Web 的编辑器。 - 如果您想继续在浏览器中工作,但需要运行命令、创建项目的测试构建或安装依赖项,可以在代码空间(codespace)中打开仓库。Codespace 是一种具备存储和计算能力的远程开发环境。它包括编辑器和集成终端,并预装了常用工具(包括 Git),帮助您完成项目所需的各种操作。更多信息,请参阅 GitHub Codespaces 快速入门。
另外,您也可以在桌面上连接到 GitHub,并使用仓库的本地副本进行工作。
在桌面上工作
要在桌面上使用仓库,您需要将仓库下载(或“克隆”)到本地电脑,然后将所做的更改推送到 GitHub。相较于在浏览器中工作,使用桌面工作有多项优势。
- 您可以使用所有本地文件和工具。
- 您能够使用本地的计算资源。例如,您可能需要运行脚本来生成站点的本地预览,以便测试所做的更改。
- 您无需互联网连接即可进行项目开发。
如果您之前从未在桌面上使用 GitHub 仓库,您需要在电脑上进行 GitHub 身份验证,以便访问所需的仓库。您还可能需要为工作环境配置所需工具,例如 Git、编辑器以及项目的依赖项。因此,与在浏览器中工作相比,使用桌面开始工作通常需要更长的准备时间。
有多种工具可用于在桌面上连接到 GitHub。这些工具可以帮助您进行身份验证、克隆仓库、跟踪更改并将更改推送到 GitHub。
- 如果您需要高度的控制和灵活性,可以使用命令行。您需要安装 Git 并熟悉一些基本的 Git 命令。您还可以安装 GitHub CLI,这是一款命令行界面,允许您在 GitHub 上执行诸如创建拉取请求或 fork 仓库等操作。更多信息,请参阅 设置 Git 与 了解 GitHub CLI。
- 如果您更喜欢可视化界面,可以使用 GitHub Desktop 等可视化 Git 客户端。使用 GitHub Desktop,您可以直观地查看所做的更改,并通过图形界面访问大多数 Git 命令,无需记忆任何命令。更多信息,请参阅 了解 GitHub Desktop。
- 如果您希望把所有工作集中在一个地方,通常可以直接在编辑器中完成大部分操作。诸如 VS Code 的编辑器自带集成终端和常用 Git 命令按钮,您可以在同一位置编辑文件并将更改推送到 GitHub。您还可以安装扩展,以便直接在编辑器中处理 GitHub 的拉取请求和议题。要开始使用,请前往 下载 VS Code。
连接 GitHub 的工具比较
下表对可在浏览器或桌面上使用的 GitHub 仓库工作工具进行了对比。
您可以使用本文介绍的任意工具完成完整的 GitHub flow。每种工具不仅提供用于跟踪更改的 Git 命令,还集成了 GitHub 特有的功能,您可以在任何工作环境中创建包含所提议更改的拉取请求。
有关如何使用这些工具对 GitHub 进行身份验证的更多信息,请参阅 了解 GitHub 身份验证。
| 工具 | 使用场景 | 浏览器或桌面 |
|---|---|---|
| 在 GitHub.com 上 | 如果您希望使用可视化界面并快速进行单次提交的简易更改,请参阅 你好,世界。 | 浏览器 |
| github.dev | 如果您想在仓库中进行比 GitHub.com 更复杂的更改,但又不需要使用终端或本地工具,请参阅 github.dev 基于 Web 的编辑器。 | 浏览器 |
| 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。 | 浏览器或桌面 |