做个人网站、改一个开源工具，或者让 AI 帮忙写脚本，迟早会碰到 GitHub。第一次打开它，最容易卡住的往往不是代码，而是一个很具体的问题：我改的文件到底存在哪儿，出了错又该去哪儿找？
这篇用一份简单的「博客选题清单」走一遍。先保存项目，再记录修改，最后试着把改动合并回去。你不需要先背完 Git 命令。
先分清：电脑上的 Git，网上的 GitHub
Git 负责记录文件的版本；GitHub 用来托管 Git 仓库，并提供讨论、评审和协作功能。
在本地完成一次 commit，只是把改动记进本地历史。执行 push，才会把相应提交送到远程仓库。还没提交的文件，也不会因为你安装了 Git 就自动得到保护。
日常先认清四个词：
| 术语 | 放在实际工作里怎么理解 |
|---|---|
| Repository，仓库 | 一份项目及其版本历史，既可以放代码，也可以放文档 |
| Commit，提交 | 一组已记录的改动，带有说明，便于以后查找 |
| Branch，分支 | 从已有进度上另开一条工作线，用来尝试修改 |
| Remote，远程仓库 | 本地仓库连接的另一份仓库，常见默认名字是 origin |
另一个值得尽早纠正的印象：GitHub 网页不只是用来浏览。 新建文件、修改内容、创建分支、发起 Pull Request，都可以在浏览器里完成。GitHub 官方的 Hello World 练习 就从网页操作开始，不要求先安装 Git。
第一次练习，只建一个小仓库
注册并验证邮箱后，先配置双重验证，把恢复码放进密码管理器或妥善保存的离线记录里。别等换手机时才想起账号恢复这件事。配置方法与恢复选项见 GitHub 账号安全文档。
接着在 GitHub 新建一个仓库，名字可以叫 field-notes。第一次练习建议选 Private，勾选添加 README。这里放的是练习资料，不放客户文件、密码或真实账号信息。
打开 README.md，写下你准备整理的三条博客选题，例如旅行网络、远程工作工具、个人网站。提交说明写「添加第一组选题」，完成提交后再把其中一条补充具体。
回到提交历史，比较前后两次内容。看见哪一行新增、哪一行改动，这次练习就有了结果。
免费个人账户支持不限数量的公开和私有仓库，也支持不限数量的协作者；部分功能仍受套餐限制。 不必因为「私有仓库只能三人协作」的旧说法，急着购买套餐。查看当前套餐范围
文件多起来，再转到本地编辑
只改一段文案，用网页就够了。需要同时改多个文件、运行测试或使用编辑器时，再把仓库克隆到电脑。你可以选 GitHub Desktop，也可以用终端；两种方式管理的是同一套版本记录。
终端操作前，先安装 Git，并配置提交者姓名、已关联 GitHub 账户的邮箱，或账户提供的隐私邮箱。这里的姓名与邮箱用于标记提交，不是登录凭据。安装和设置可按 GitHub 的 Git 配置说明 完成。
认证则是另一件事：
- 使用 GitHub Desktop，可以通过浏览器登录。
- 使用 HTTPS 命令行访问，可以选择凭据管理器、GitHub CLI 的登录流程，或合适权限的个人访问令牌。
- 使用 SSH，需要把本机生成的公钥添加到 GitHub，私钥留在自己设备上。
GitHub 的 Git 操作已不再接受账户密码作为 HTTPS 认证密码。也别把令牌直接拼进仓库 URL，免得它留在终端历史或配置文件里。认证方式说明
认证准备好后，把下面的 TARGET 替换成你自己仓库 Code 按钮下的克隆地址：采用 HTTPS 认证就选 HTTPS 地址，只配置了 SSH 公钥就选 SSH 地址。field-notes 是准备新建的本地目录名，若已有同名目录，先换一个名字。
git clone TARGET field-notes
cd field-notes
git status
用编辑器修改 README.md。保存文件后，先检查差异，再决定提交哪些内容：
git diff
git add README.md
git diff --staged
git commit -m "补充选题适合的读者"
git push
这里特意没有一上来就用 git add .。练习时指定文件，更容易知道自己准备提交什么。git diff 看尚未暂存的修改；git diff --staged 看这次将进入提交的修改。新建而尚未跟踪的文件不会直接出现在普通 git diff 里，要结合 git status 检查。具体状态的区别见 Git 官方说明。
如果推送被拒绝，先看报错。认证失败、没有写入权限、远程有更新，是不同的问题。不要把强制推送当成通用修复按钮。
学会分支，给修改留出检查的位置
假设你想把选题清单改成一张表，但还没确定新格式是否好读，可以先开一个分支：
git switch -c improve-reading-list
修改文件后提交，再把这个分支推到自己的远程仓库：
git add README.md
git diff --staged
git commit -m "按读者需求整理选题表"
git push -u origin improve-reading-list
回到 GitHub，创建一个从该分支合并到默认分支的 Pull Request，简称 PR。打开差异页面，确认这次只包含想要的修改，再合并。
在这份自建练习仓库里，你可以自己完成整个流程。参与别人的项目时，先阅读贡献说明；没有写入权限时，通常先 Fork 到自己账户，再从自己的分支提交 PR。维护者是否接受改动，要经过对方的评审。
写 PR 描述时，说明改了什么、为什么改、怎样检查过。对方提出修改意见后，继续提交到同一个分支，PR 会随之更新。流程可对照 GitHub flow。
找开源工具，别只看收藏数
需要一个博客主题或小工具时，Star 数可以作为发现线索，但不适合单独决定是否使用。打开项目后，先做一轮检查：
- 读 README。 它解决的问题是不是你眼前的问题？有没有安装方法和可用示例？
- 看维护情况。 最近的发布、提交和问题回复，能帮助你判断遇到故障时是否有线索可查。
- 看运行要求。 需要哪些服务、系统权限、账号或 API 密钥？先看清楚，再执行安装命令。
- 读许可证。 公开可见与获得复用许可是两回事，使用前查看项目的 LICENSE 和相关说明。GitHub 的许可证说明
如果只是想参与一次协作，可以从说明文档或明确标注的新手任务开始。先确认问题仍然存在，再提出小范围改动，比随手发一个大 PR 更容易沟通。寻找贡献入口
想把项目变成网站，先分清 Pages 和 Actions
Pages：发布静态内容
GitHub Pages 用来发布 HTML、CSS、JavaScript 等静态文件，也支持先构建再发布。个人介绍、项目文档、静态博客，都可以从这里了解部署流程。
Pages 不是一台可长期运行后端进程的 VPS。 如果网站需要数据库写入、管理后台或常驻服务，还需要其他后端安排。对于个人免费套餐，Pages 适用于公开仓库；其他套餐的范围以官方说明为准。Pages 的用途与范围
Actions：按规则执行任务
Actions 更像项目里的自动化工序：提交后检查格式、运行测试，或者在发布时生成站点文件。它不是「开一个任务就得到一台永久免费的服务器」。
刚开始，先把一条检查命令在本地跑通，再考虑放进工作流。涉及密钥时使用平台的 Secrets 机制，按需要授予权限；不要把凭据写进配置文件后提交。
额度、执行器与存储的计费规则会变化。配置前查看自己的套餐与用量，不照搬旧教程里的分钟数或系统倍率。Actions 计费说明
发布之前，做一次收尾检查
个人项目也值得养成几个习惯：
- 提交前看
git status和本次差异，排除.env、私钥、令牌、客户资料和无关文件。 .gitignore用来忽略尚未跟踪的文件；已经进入版本历史的敏感内容，不会因为后来加入忽略规则就消失。- 若凭据已经泄露，先撤销或更换，再处理历史和其他副本。只删掉当前页面里的文件不够。移除敏感数据的官方说明
- 准备交给 AI 操作时，说清楚允许修改的文件、检查方式，以及是否允许提交、推送和部署。生成完成后，仍然检查真实差异。
第一次练习的目标可以很小：仓库里有一份清单，历史中能找到两次修改，你知道某条记录为何出现，也能确认远程已经收到它。做到这里，再按实际需要学习网站发布或自动化，会轻松得多。
来源与编辑说明
选题来自 想风（@xaiwind）在 X 发布的 GitHub 教程。本文由 X 游民重新组织练习场景与内容，并结合文中链接的 GitHub、Git 官方文档核对；不是原文逐段转载，也不将原作者的个人经历作为本站实测。
核对日期：2026 年 10 月 4 日。产品功能、套餐与界面可能调整，请以操作时的官方说明为准。封面为 AI 生成的概念图，不是 GitHub 官方素材或产品截图。
