程序员如何做「代码设计」：不是炫技，是简洁

代码设计是程序员日常工作中最核心的技能。

设计好的代码易读、易改、不出错；设计差的代码是噩梦的开始。

---

一、代码设计的原则

1. 单一职责

一个函数只做一件事。

函数太长、参数太多，通常是违反了这个原则。

2. 开闭原则

对扩展开放，对修改关闭。

新功能通过扩展实现，不通过修改已有代码。

3. 依赖倒置

依赖抽象，不依赖具体实现。

用接口、抽象类，而不是具体类。

4. 最少知识

只和直接相关的类交互。

不要调用链太长，耦合太深。

---

二、代码设计的方法

1. 从需求出发

先想清楚这个代码要解决什么问题。

不是为了"设计模式"而设计。

2. 先写注释

用注释描述你要写的代码逻辑，再写代码。

能写清楚注释，代码就成功了一半。

3. 画类图

复杂模块先画类图，理清关系再写。

4. 先简单后复杂

先用最简单的方案，复杂是后来演进出来的。

---

三、好代码的特征

1. 可读

别人一眼能看懂你要做什么。

命名规范、结构清晰、注释到位。

2. 可测试

每个函数都能独立测试。

依赖要能注入，方便 mock。

3. 可扩展

加新功能不需要改太多代码。

模块之间通过接口交互。

4. 可维护

出问题能快速定位、修复。

日志清晰、错误处理到位。

---

四、常见错误

❌ 过度设计

一个简单的 CRUD 用了 10 个设计模式。

设计要为需求服务。

❌ 不考虑测试

写完代码没法 unit test，说明设计有问题。

❌ 命名随意

a、temp、data——这样的变量名等于没有命名。

❌ 函数太长

超过 50 行就要考虑拆分了。

---

五、一句话总结

代码设计 = 单一职责 + 开闭原则 + 依赖倒置 + 最少知识，核心是简洁和可演进。