软件工程主书
建立可协作、可演进和可交付的软件开发方法。
阅读起点
先从本页第一章开始；如果对应概念已经熟悉，可以从目录中选择需要补齐的章节。
全书顺序
本书按知识依赖组织。主线先建立可运行的共同模型，再进入机制、工程边界和生产约束；维护与前沿内容明确标注，不改变主线的学习顺序。
第1章｜代码质量、设计与评审
从可读代码、设计模式和评审建立能安全改变代码的个人与团队习惯。
- 代码质量与坏味道：识别复杂度、重复、耦合和可维护性信号。
- 重构与测试保护：在可观察行为不变的前提下逐步改进结构。
- 设计模式与反模式：根据变化点和成本选择模式，避免模式化堆叠。
- 代码评审与协作：用上下文、风险和可验证证据进行评审。
第2章｜需求、估算与迭代
把用户价值、范围、不确定性和交付节奏连接起来。
第3章｜架构决策与工程文档
用记录和文档保存上下文，让团队可以复盘和接手。
- ADR 决策记录：记录背景、选项、取舍和后果。
- README、API 与架构图：让文档成为可执行的协作契约。
- 运行手册与知识传承：把部署、监控、故障和恢复步骤写成可操作手册。
第4章｜发布、版本与开发体验（维护与兼容）
管理软件从变更到交付的反馈循环和维护边界。
- 语义化版本与变更日志：表达兼容边界并让发布结果可追踪。
- 发布、回滚与演进：设计冻结、灰度、回滚和旧版本兼容策略。
- 本地环境与构建反馈：缩短从编码到验证的反馈循环并保持环境一致。
阅读边界
本页是学习路线和专题入口，不替代专题笔记中的机制解释、可运行示例和练习。笔记尚未完成的专题会先显示为占位页；已有经验的读者可以跳到具体章节，再按前置关系回补。
路线状态
本路线的目录已经纳入路线架构，正文笔记仍处于占位或待审查状态。