# Common Coding Style

## 核心原则

- 先保证可读性、可验证性和变更边界清晰，再追求抽象和“优雅”。
- 小步修改、结论先行，避免一次提交多种不相干重构。
- 命名表达意图，不把上下文藏进缩写和模糊术语。
- 结构优先于技巧；能直写清楚的逻辑，不用炫技式压缩。

## 文件与模块

- 一个文件只承载一个主职责，避免既定义协议又处理 IO 又做格式转换。
- 复杂逻辑拆成可验证的小单元，公共逻辑优先沉淀到稳定边界。
- 变更要附带影响面说明，帮助 reviewer 快速判断风险。

## Review 红线

- 未处理错误路径、边界态或回滚路径。
- 为了短期快而引入隐式耦合或难以追溯的副作用。
- 没有验证依据，却宣称“应该没问题”。