· 约 2 分钟
《开发第一性原理》系列导览
一句话核心：怎么让开发工作可被维护、可被接手、可被信任。
这个系列记录的是我在 SAP/ABAP 开发里反复验证过的基本规律。12+ 篇不是 12 个独立主题，而是一个完整体系的 12 个切面：
遇到故障——能排；遇到失败——能存；遇到代码——能测；遇到历史——能找到。
系列目录
排障方法论 · 01-04
出了问题怎么排？这 4 篇合起来是一套完整的排障方法论：先查什么、在哪查、怎么定位。
- 01 · 越诡异的 Bug，越可能是低级错误 —— 奥卡姆剃刀，先查基础
- 02 · 复杂问题，要先学会”切” —— 分而治之，按职责切
- 03 · 为什么一个数据只能有一个源头 —— 单一信息源（SSoT）
- 04 · 找不到问题点？把范围砍一半试试 —— 二分定位
失败处理 · 05-06
失败不可避免，关键是失败信息不被吞掉。05 管”事后保留”，06 管”事前防御”。
- 05 · 为什么”友好化”反而害了排障 —— 包装不替换、累加不丢弃，消息链不能断
- 06 · 先定界，再写码 —— 和业务把数据边界讲清楚
开发者测试 · 07
写完的代码怎么测、怎么不埋雷。接过 06 的”想到边界”，讲”测到边界”。
- 07 · 别用理想化数据测 —— 测试通过不等于代码能跑
信息可被找到 · 08-12
开发完之后，怎么不被埋没。5 篇从微观到宏观层层递进：字面量 → 信息源 → 代码组织 → 文档 → 跨包关系。
- 08 · 魔术数 = 你现在记得，未来的你不记得 —— 字面量抽常量
- 09 · 配置表泛滥怎么治理 —— 配置表不是建完就完，是要被找到的
- 10 · 自我描述的代码 —— 命名 + 结构 + 职责，让代码自带导航
- 11 · 文档和代码的有机结合 —— 别让它们各自分裂
- 12 · 包间引用与迁移治理 —— 让规范不只是文档
怎么读
- 第一次读：按 01 → 12 顺序，先把框架建起来。
- 赶时间：排障看 01 + 04 + 05；写代码看 02 + 06 + 08 + 10 + 12；接手老项目看 09 + 10 + 11 + 12。
开发的难度不在写代码本身，而在让代码可被维护、可被接手、可被信任。整个系列回答的，就是这一个问题。
系列会持续扩展，每新增一篇，本文目录同步更新。