架构决策记录(ADR)是记录架构决策的轻量级方法，帮助团队理解架构演进的原因和过程。
本文系统介绍ADR的核心概念、编写方法和实战案例，帮助你建立架构决策文档化体系。
一、为什么需要ADR
1.1 架构决策问题
架构决策问题：
1. 决策原因不明确
├─ 为什么选择这个技术？
├─ 有什么替代方案？
└─ 为什么放弃其他方案？
2. 决策过程不透明
├─ 谁参与了决策？
├─ 考虑了哪些因素？
└─ 如何达成共识？
3. 决策结果不持久
├─ 决策文档丢失
├─ 新人不了解历史
└─ 重复讨论已决策事项2026/8/19大约 4 分钟