什么使得一个好的 commit 和 commit 消息？

Question

Accepted Answer

好的 commits 是**专注的**（一个逻辑变更）且带有**清晰的消息**，说明了什么改变了以及为什么改变。精心编写的 commits 和消息使项目历史可读、有用，便于理解变更、调试和协作。

## 好的 commit 消息

```text
GOOD message structure:
  Short summary line (~50 chars, imperative mood, capitalized, no period)
  <blank line>
  Optional body: explain WHAT and WHY (not how — the code shows how),
  wrap at ~72 chars. Reference issues if relevant.
```

```text
✅ GOOD:
  Add user email validation to registration form

Validate email format before submission to prevent invalid
  accounts. Fixes #142.

❌ BAD:
  "fixed stuff", "update", "asdf", "changes", "wip"
  → vague, uninformative — useless when reviewing history later
```

## 祈使语气约定

```text
Write the summary as a COMMAND/instruction (imperative):
  ✓ "Add feature", "Fix bug", "Update docs", "Remove dead code"
  ✗ "Added feature", "Fixes bug", "Updating docs"
→ Convention: it reads as "this commit will [Add feature]" (matches Git's own messages).
```

## 好的 commits：原子性和专注

```text
✓ ATOMIC — each commit is ONE logical change (not many unrelated changes lumped together)
✓ Focused — "Add login" and "Fix typo" are SEPARATE commits, not one
✓ Working — ideally each commit leaves the code in a working state
Why: focused commits are easier to REVIEW, REVERT (undo one change cleanly),
  understand, and bisect (find which commit introduced a bug).
```

## Conventional Commits（一个流行的标准）

```text
type(scope): description    → feat: add login | fix: handle null | docs: update README
  types: feat, fix, docs, refactor, test, chore, etc.
→ Enables automated changelogs/versioning; widely adopted in many projects.
```

## 为什么这很重要

理解什么使得好的 commits 和 commit 消息对于**创建可读的、有用的项目历史**很有价值，因此这是重要的实用知识，可显著影响协作和可维护性。**好的 commit 消息**很重要，因为 commit 历史是一种至关重要的文档形式 — 清晰的消息（一个简洁的摘要说明*什么*改变了，必要时用正文说明*为什么*）使得可以理解代码是如何以及为什么演变的，这在查看历史、调试（理解为什么进行了某个改变）或新人入职时无价。

模糊的消息（"fixed stuff"、"update"、"wip"）会使历史无用，使得后来无法理解变更 — 这是一个真实的成本。

**祈使语气约定**（"Add feature" 而非 "Added feature"）是一个广泛遵循的值得了解的标准。**好的 commits 是原子性和专注的**（每个 commit 一个逻辑变更，而不是把很多不相关的变更混在一起）同样重要：专注的 commits 更容易被**审查**（审查者理解一个变更）、**撤销**（清晰地撤销一个变更而不影响其他变更）、理解和**二分查找**（找出哪个 commit 引入了 bug）— 因此 commit 结构直接影响历史对于调试和协作的可用性。

了解 **Conventional Commits**（`type(scope): description` 标准，支持自动生成 changelogs 和版本控制）很有价值，因为它被广泛采用。

由于 commit 历史是重要的文档，好的 commits/消息使其可读且有用（用于理解、审查、调试和协作），而差的消息使其无用，且编写专注的 commits 和清晰的消息是专业 Git 实践的标志，理解什么使得好的 commits 和 commit 消息是有价值的、实际相关的知识，对于有效的协作和可维护的历史很重要 — 一种区分思考周密的开发者并有意义地改进项目长期可用性和团队工作流程的技能。