Git 与 GitHub 从零到实战

这是一个可以亲手操作的中文学习仓库。你会在一个真实的小型 Node.js 任务项目中练习提交、分支、冲突、Pull Request、回退和 GitHub Actions，而不是只背命令。

你会学到什么

工作目录 ─git add→ 暂存区 ─git commit→ 本地仓库 ─git push→ GitHub
    ↑                    ↓
 git restore        git restore --staged

• 理解 Git 与 GitHub 的区别；
• 掌握 status → diff → add → commit → push；
• 用功能分支和 Pull Request 安全开发；
• 亲手制造并解决一次合并冲突；
• 区分 restore、revert、reset 和 reflog；
• 读懂 GitHub Actions 的绿色对勾和红色失败；
• 将这套流程用到 PersonaLink 等真实项目。

七天学习路线

天	主题	完成标志
1	安装、配置与概念	能解释工作目录/暂存区/提交
2	第一次完整提交	能不看答案完成一次 commit
3	GitHub 远程仓库与认证	能 clone、pull、push
4	分支与 Pull Request	完成第一个 PR
5	合并冲突实验	能看懂并删除冲突标记
6	撤销、回退与找回代码	能为不同错误选正确命令
7	Actions 与真实开发流程	CI 全绿后再合并/发布

学完后可继续做 PersonaLink 模拟实战。忘记命令时查 命令速查表，遇到报错时查 常见问题。

第一次运行示例项目

需要 Node.js 22+：

git clone https://github.com/Abner199/git-demo.git
cd git-demo
npm ci
npm test
npm start

npm test 会运行 3 个测试，npm start 会打印一张学习任务表。如果只想学 Git，前几章不需要 Node.js。

练习原则

1. 每次输入命令前先运行 git status。
2. git diff 看清改了什么，再 git add。
3. 一个 commit 只表达一个意图。
4. 提交到 GitHub 的错误优先用 git revert，不要改写公开历史。
5. 不提交密码、Token、.env、数据库或个人隐私。

仓库结构

.github/workflows/ci.yml  # GitHub Actions 案例
docs/                     # 分章教程、速查和排错
practice/                 # 分支和冲突练习文件
src/                      # 小型任务示例
test/                     # Node.js 自带测试
CONTRIBUTING.md           # 模拟团队协作规则

官方参考

• Git 命令参考
• GitHub Flow
• GitHub SSH 认证
• GitHub Actions 示例