构建之法阅读笔记04

《构建之法》第四章阅读笔记

（阅读范围：第4章 "两人合作"）

---

一、本章核心内容总结

1. 代码规范的重要性

   • 统一代码风格（命名、缩进、注释等）提高可读性
   • 设计规范（函数长度、模块划分等）确保可维护性

2. 代码复审的价值

   • 发现潜在缺陷（平均每千行代码存在15-50个错误）
   • 知识共享的重要途径，团队能力提升的关键机制

3. 结对编程实践

   • 驾驶员+领航员模式的优势与适用场景
   • 效率数据：初期速度降低15%，但缺陷率减少45%

4. 合作阶段模型

   • 磨合期→规范期→创造期→调整期的特征与应对策略

---

二、个人反思与改进方案

1. 过去的问题行为
   在今年与同学合作系统开发中，我们两人小组：

   • 各自开发不同模块，合并时发现：
     • 命名冲突（他用getUserInfo()我用queryUserData()）
     • 相同功能重复实现（购物车校验逻辑写了两个版本）
   • 代码评审流于形式，仅检查基础语法错误
   • 拒绝结对编程，认为"影响个人效率"

2. 理论对照分析

   • 规范缺失：违反4.2节"代码是给人看的"原则，增加维护成本
   • 复审失效：未达到4.4节要求的"每千行代码至少2小时复审"标准
   • 合作低效：忽略4.5节"结对编程可提升长期质量"的实证数据

3. 具体改进方案
   1) 自动化规范检查（解决风格问题）

   • 配置团队统一的EditorConfig+Prettier规则
   • 重要接口强制API文档生成（Swagger）

   2) 分层代码复审

   3) 渐进式结对实践

   • 第一阶段：关键模块结对（如支付系统）
   • 第二阶段：每日1小时轮换结对
   • 第三阶段：全功能结对+屏幕共享编程

---

三、改进计划

1. 写反思日记

   ## 2024-03-20 合作日志  
   - **今日结对时长**: 2.5小时  
   - **发现的主要问题**:  
     1. ···
   - **改进措施**:  
     -···