G
01 · 介绍
GitHub 是什么
Git 会保存一组文件的每一次变更历史。GitHub 是一个网站，用来托管这些历史，并在其上增加团队协作功能。
你会遇到的词汇：
- 仓库（repo）：一个项目及其完整历史。
- 提交（Commit）：一次保存下来的变更，附带说明原因的消息。
- 分支（Branch）：一个侧边副本，你可以在其中工作而不影响主版本。
- 拉取请求（Pull request，PR）：“这是我的分支，请审查并合并”。讨论和审查都在这里进行。
- 议题（Issue）：用于记录缺陷或任务的工单。
- Actions：在某些内容发生变化时自动运行的自动化流程，例如每次拉取请求都运行测试。
AI 编程智能体（Codex、Claude Code、Copilot）会读取仓库，并以拉取请求的形式交付工作成果，因此掌握一些 GitHub 的基本操作会非常有帮助。
02 · 适合什么场景
何时需要它
- 你与 AI 编程代理协作，希望能查看、审阅并撤销它的修改。
- 一个小团队共享脚本、提示词或配置，需要一个带有历史记录的统一存放位置。
- 你希望在有内容变更时自动运行测试或部署。
- 你要发布供他人复用的内容：工具、模板或数据集。
03 · 配置
入门使用
- 在 github.com 注册一个账号，并开启双因素认证（two-factor authentication）。
- 安装 GitHub Desktop（无需命令行），或安装
git命令行工具。 - 创建一个代码仓库（repository），将其克隆（clone）到你的电脑上，添加一个文件，用一条说明信息提交（commit），然后推送（push）。
- 创建一个分支（branch），修改一些内容，在网站上发起拉取请求（pull request），然后合并（merge）。
先用一个一次性的练习项目完整操作一遍；之后，智能体提交的拉取请求你就能看懂了。
04 · 使用说明
日常使用
- 逐个文件审查拉取请求（file by file），不要把整个 diff 当成一面红绿交错的墙。对有疑问的行留下评论。
- 让 Actions 在每个拉取请求上运行测试；红色的检查就是一位免费的审查者。
- 撰写提交信息时说明为什么，而不是做了什么；diff 本身已经展示了做了什么。
- 不要把机密信息放进代码仓库。在 Actions 中使用仓库的 Secrets 设置，本地则使用被 git 忽略的
.env文件。 - Copilot（GitHub 自家的助手）可以审查拉取请求，并在网站内直接提出修复建议。
05 · 注意事项
常见陷阱
- 一旦代码仓库公开，提交到其中的 API 密钥也随之公开，即使之后删除，它仍然保留在历史记录中。请轮换该密钥。
- 合并一个你没有阅读过的拉取请求，等同于你自己编写了这些代码。
- 强制推送会重写历史记录，可能抹掉同事的工作成果；在共享分支上请避免使用。
- 免费的私有仓库对 Actions 分钟数有限制，大型测试套件可能会用完这些分钟数。
06 · 资源
接下来去哪里
Skills 课程和 Copilot 页面涵盖了非开发者需要的全部内容。
我的笔记
登录后可以在这本手册上记私人笔记。登录