Avalon Wiki正在加载文章…
从一次清晰的提交开始，理解分支、差异与可恢复的工作方式。
这是一篇演示指南，命令以本地 Git 仓库为例。 Git 保存的是一系列可以回看的版本； 一次提交最好只解释一件事情，例如“修复移动端目录溢出”，而不是“改了一些东西”。
在执行任何修改前，先观察当前状态：
# 查看哪些文件发生了变化
git status
# 查看尚未暂存的具体差异
git diff确认修改符合预期后，把需要提交的文件加入暂存区。 显式选择文件，能帮助你避免顺手提交临时文件或配置。
git add content/docs/development/git-basics.mdx
git diff --staged
git commit -m "docs: clarify the basic Git workflow"提交前再看一遍差异
暂存区是一张准备保存的快照。 git diff --staged 展示的，正是下一次提交将记录的内容。
分支是指向某个提交的名字。 为一个独立任务创建分支，可以让修改的范围和目的更清晰。
# 从当前状态开始一个新任务
git switch -c docs/improve-navigation
# 查看分支与最近提交
git log --oneline --graph -8分支本身不替代备份。 重要改动提交后，还需要按自己的远程仓库策略同步。
| 想做什么 | 命令 | 需要注意 |
|---|---|---|
| 查看状态 | git status | 先观察再行动 |
| 查看差异 | git diff | 默认不含已暂存修改 |
| 查看历史 | git log --oneline | 可加 -8 限制条数 |
| 新建分支 | git switch -c 名称 | 从当前提交开始 |
| 查看暂存差异 | git diff --staged | 提交前检查 |
好的提交说明包含具体动作和原因。 必要时在提交正文补充：问题如何触发、为什么选择这个方案、如何验证。
如果修改涉及多件不相关的事，可以拆成几次提交。 之后定位问题、比较方案或撤销某项修改，都会更容易。
继续阅读如何组织长期笔记，把版本记录与知识整理结合起来。