8. 实战:本博客定版流程
这是什么:一条真实的发布链——从「我想改点内容」到「线上生效」,把前 7 章的 Git 招式全部串起来。
为什么用:前 7 章每章都单练过,可真到了自己的项目上,你还是会在「先 pull 还是先改」「中文 commit 怎么写」「改完要不要删分支」这些问题上卡壳。单点会了、串起来还不会,等于没学。
如何用:本章以本博客仓库为例,照着「同步 → 开分支 → 提交 → 推送 → PR → 合并 → 删分支」这条路,把一次真实发布从头走完。
8.1 场景设定
目标:修正一篇教程(也可以是任何内容)并发布。环境:
- 本地:克隆好本博客仓库(
git clone,第 6 章) - 远程:Gitee
master(本仓库的主分支叫 master) - 生产:阿里云部署(第 8 章只管仓库动作,部署见 deploy.md)
8.2 五步全流程
① 先同步(老规矩)
git switch master
git pull # 永远从最新起点
② 开分支
git switch -c docs_修正写作指南
③ 改动 + 提交循环(可多次)
nano doc/authoring.md # 或 VSCode 打开项目
git status
git add doc/authoring.md
git commit -F msg.txt # 中文 message 用文件(第 3 章规矩)
msg.txt 内容示例:
docs: 修正写作指南的示例链接
④ 完事推送 + 平台 PR(第 7 章)
git push -u origin docs_修正写作指南
Gitee 页面点「发起 Pull Request」→ 同事评审 → 合并进 master。
⑤ 合并后:删分支、再次同步
git switch master
git pull # 带回刚合并的成果
git branch -d docs_修正写作指南
8.3 每一步对应的知识点
| 步骤 | 学自 | 容易踩的坑 |
|---|---|---|
| pull 最先做 | 第 6 章 | 忘了 → push rejected |
| 新分支干活 | 第 4 章 | 直接在 master 改 |
| commit -F 文件 | 第 3 章 | 中文命令行乱码 |
| push -u / PR | 第 6、7 章 | push 到别人分支 |
| 删分支、再 pull | 第 4、6 章 | 分支同阶段不同步 |
8.4 本仓库的真实历史(阅读训练)
读别人仓库是学 Git 最高效的方法之一:
git lg -- doc/ # 只看文档变更历史
git show <hash> # 看某次提交改了什么
git log --oneline --since="2026-10-01"
你会看到像这样的时间线(本次教程上线一次提交 16 个文件):
1d2abc2 feat: 上线第一批教程(CSS 8 章 + MySQL 8 章)
训练任务:找到本仓库第一笔 commit,.statistic看那时项目多小。
8.5 动手改(真发布一次)
- 本地给任何一篇教程挑一处小问题(错字/链接),完整走一遍五步
- 合并后把
python v2/build.py --all的产物在本地 preview 验证内容 - 挑战:给 README.md 的「内容结构」表补一行(模拟未来新技术栈),同样走五步
8.6 小结
- 一条发布链:pull → 分支 → 改+commit → push → PR,完成后删分支再 pull
- 危险上账:忘 pull、在 master 直接改、中文 message 裸 -m
- 会读历史 = 会负责:
git lg -- doc/+git show是你的时间机器入口
Git 入门完成!接下来把语言课补上:Go 基础 🐸