二、代码质量差的根因

（一）表现现象

质量差的代码常常表现出多种令人困扰的现象。命名不知所意是常见问题之一，例如变量名、方法名或类名让人摸不着头脑，初看根本不知道其代表的含义。超大类也是一个突出表现，一个类可能包含数千行代码，使得代码的复杂度极高，难以理解和维护。超大方法同样如此，几百行的方法会让阅读者陷入混乱，难以快速把握其核心逻辑。重复代码的出现不仅增加了代码量，还使得出错的几率大幅提升，因为一处修改可能需要在多个地方同步进行调整，而维护者很容易遗漏某些位置。代码难懂则可能是由于缺乏注释、格式不统一或者过度使用复杂的技术手段，如大量无节制的 Lambda 表达式，虽然看起来简洁，但实际上降低了代码的可读性。代码修改困难往往是因为代码的可扩展性差，新业务需求提出后，需要在多处进行改动，回归的业务逻辑较多，导致研发效率低下。

（二）问题归纳

1. 命名问题：命名问题分为不知所云和名不副实两种。命名不知所云是指初看不知道其意思，根本原因是没有找到合适的词汇抽象问题；名不副实则是命名与实际逻辑表达的意思不一样，容易误导他人。

1. 代码结构问题：从模块、类、方法的划分可以感受代码质量。一个类几千行代码或一个方法几百行代码的情况会让人望而却步，复杂度高。好的代码层次结构清晰，如同优美的书籍一般赏心悦目。

1. 编程范式问题：有表模式、事务脚本模式和领域设计模式三种编程范式，其中事务脚本模式最常用，但容易成为 “面条型代码”，承担不该承担的职责。

1. 可读性问题：代码除实现业务功能外，还应具备良好的可读性。缺乏注释、格式不统一、过度使用 Lambda 表达式等都会降低可读性。

1. 扩展性问题：良好的可扩展性不容易实现，通常是因为没有进行抽象。例如店铺在店招头展示 Tab 的例子，如果直接定义 List 加 Tab 对象，再加一个 Tab 时就不满足开闭原则。

1. 无设计问题：整个代码平淡无奇，没有深入分析问题，只是解决了表面问题，未考虑更好的解决方法，如是否能抽象出通用模板类、使用工厂类获取策略等。

（三）根因分析

产生代码差的原因既有外部因素，也有内部因素。外部原因主要包括项目排期急，没有时间设计；资源短缺，人手不够，只能求快；紧急问题修复，采用临时方案快速处理。内部原因主要是自身技能低，如未掌握 Lambda 表达式、常用工具类、框架高级用法等重要技能；同时缺乏极致追求的精神，仅仅满足完成需求，不考虑稳定性、可扩展性、性能、数据一致性等。最为关键的是内部自身的问题，根因在于自我要求不高和无反馈通道。如果对自己要求不高，仅满足完成需求开发，就很难写出高质量的代码。而且如果没有外部反馈，也难以提高自己的技能。