6.5 常见误区与综合实践

面向经管学生、研究者与从业者的 AI 智能体设计教材

6.5 配图

最后用一个典型场景，把本章命令和判断串起来。

假设你在一个文档项目中需要同时做三件事：调整目录结构和导航配置、重写某个章节的正文、更新项目说明和配置文件。比较稳的一条本地流程如下：

git switch -c part2-git-reorder
git status
git diff
git add _quarto-full.yml _quarto-selection.yml
git add chapters/chapter-6/section-6-1.qmd
git add chapters/chapter-6/section-6-2.qmd
git add chapters/chapter-6/section-6-3.qmd
git add chapters/chapter-6/section-6-4.qmd
git add chapters/chapter-6/section-6-5.qmd
git add chapters/chapter-6/section-6-6.qmd
git add chapters/preface/preface.md README.md CLAUDE.md 教材大纲_最新版.md TODO.md
git diff --cached
git commit -m "docs: reorder part two and rewrite git chapter"
git log --oneline -n 3

如果你发现某个文件其实不该进这次提交，可以先撤掉暂存：

git restore --staged chapters/chapter-7/section-7-5.qmd  # 示例：撤掉另一章的误加文件

五个最常见误区

1. 直接 git add . —— 最容易把临时文件、顺手改动和无关修补一起送进历史。
2. 不看 diff 就提交 —— AI 写得快，不等于每一行都该保留。
3. 一条提交同时解决很多问题 —— 提交越杂，后面越难审，也越难回退。
4. 把回退当成失败 —— 真正危险的不是回退，而是没有回退点。
5. 还没形成本地提交，就急着讨论 PR 和 CI —— 没有本地版本点，后面的协作接口没有稳定对象可审。

学会 Git 的第一步，不是背一长串命令，而是把版本边界建立起来。只要能稳定做到下面这条链，本章目标就达成了：

看状态 -> 看 diff -> 选择性暂存 -> 本地提交 -> 查看历史 -> 必要时回退

后面再接分支、Worktree、PR、Hooks 和评估，整套协作流程才会真正稳下来。