什么是好代码？一位资深工程师的深度思考

关注我，每天收获一个新技能!

Dave Farley 是我的前同事，他也是《持续交付》一书的作者之一。

本文整理自他的视频，讨论了#代码健康 相关的话题，希望能给每位开发者带来启发和思考。如果您觉得有收获，欢迎分享和讨论。

1

深度解析

1. 什么是糟糕的代码？

我们经常说"这是糟糕的代码"，但到底什么是糟糕的代码？有两个根本性的判断标准：

• 代码无法完成预期功能

• 代码难以修改和维护

这个定义非常简单，实用和务实，避免了过于理论化的讨论。

2. 代码质量与开发效率

DORA^[1]的研究数据，指出：

• 高质量代码的团队在新功能开发上的时间比例高出44%

• 为了快速交付而牺牲代码质量是一个误区

• 高质量代码实际上能带来更快的开发速度

3. 代码可读性的深层含义

对代码可读性的要求：

- 不仅要作者自己能读懂 

- 理想情况下，了解业务领域的非程序员也应该能理解代码的核心逻辑 

    - 比如医疗软件应该让医生能理解，游戏代码应该让玩家能理解

2

实践建议

• 采用测试驱动开发

  - 从一开始就编写测试    

  - 让代码天然具备可测试性    

  - 促进模块化和低耦合设计

注重代码组织

    - 每个部分只做一件事    

    - 通过抽象隐藏实现细节    

    - 保持各个部分的独立性

重视命名和接口设计

    - 使用描述性的命名    

    - 设计直观的接口    

    - 让代码自解释

1. 控制复杂度

   - 避免不必要的状态变化    

   - 减少副作用    

   - 保持行为的可预测性

3

文章要点总结

• 好代码的两个根本标准：   

    - 能完成它应该完成的功能   

    - 容易修改和维护

• 代码质量对效率的影响：   

    - 高质量代码的团队在新功能开发上效率高出44%   

    - 快速写出糟糕的代码反而会降低整体开发效率

• 好代码的核心特征：   

    - 可读性强：非技术人员也能理解核心逻辑   

    - 模块化：每个部分专注于单一任务   

    - 低耦合：各部分之间依赖最小化   

    - 可测试：便于进行单元测试

• 实现好代码的方法：   

    - 采用测试驱动开发(TDD)   

    - 注重代码的分层和抽象   

    - 精心设计命名和接口   

    - 避免副作用，保持行为确定性