一、模块化编程概述

1.1 什么是模块化编程

模块化编程，说白了就是把一个大型程序拆成若干个小块。每个小块负责一个独立的功能，彼此之间通过明确的接口来沟通。

我刚开始做嵌入式开发时，写过一段"面条代码"——一个 main.c 文件里塞了三千多行，全局变量满天飞。后来改一个 bug，改了三天，结果又引出两个新 bug。那滋味，真不好受。

模块化编程的核心思想就四个字：高内聚，低耦合。

• 高内聚：一个模块内部的功能要紧密相关。比如一个 LED 驱动模块，只负责 LED 的初始化、亮灭控制，别把温度传感器的代码也塞进去。
• 低耦合：模块之间的依赖要尽量少。A 模块改了，B 模块不应该跟着改。

举个例子，一个简单的 LED 模块：

// led.h —— 接口
#ifndef LED_H
#define LED_H

void led_init(void);
void led_on(void);
void led_off(void);
void led_toggle(void);

#endif

// led.c —— 实现
#include "led.h"
#include "gpio.h"

static uint8_t led_state = 0;

void led_init(void) {
    gpio_set_mode(LED_PIN, OUTPUT);
    led_off();
}

void led_on(void) {
    gpio_write(LED_PIN, HIGH);
    led_state = 1;
}

void led_off(void) {
    gpio_write(LED_PIN, LOW);
    led_state = 0;
}

void led_toggle(void) {
    if (led_state) led_off();
    else led_on();
}

你看，外部只需要知道 led_init()、led_on() 这些函数名，根本不用关心底层 GPIO 怎么配置的。这就是模块化的魅力。

1.2 为什么需要模块化

你想想看，一个嵌入式项目少则几千行，多则几十万行。如果不做模块化，会是什么场景？

• 想找一个函数，得在几千行代码里翻来翻去
• 改了一个全局变量，不知道会影响哪些地方
• 新同事加入，光看懂代码就要一个月
• 想复用某个功能，发现和别的代码纠缠在一起，根本拆不开

我在一个工业控制项目中遇到过这种情况。当时项目赶进度，大家各写各的，没有做模块划分。结果到了联调阶段，一个定时器中断服务函数里调用了五个模块的函数，互相依赖，死锁频发。最后花了整整两周才理清关系。

模块化编程能解决这些问题：

1. 降低复杂度：一次只关注一个模块，大脑负担小很多
2. 提高可维护性：改一个模块，不影响其他模块
3. 促进复用：写好的模块可以直接用到下一个项目
4. 便于团队协作：每人负责一个模块，接口定好就行
5. 方便测试：可以单独测试每个模块，不用等整个系统跑起来

1.3 模块化编程的优缺点

任何技术都有两面性，模块化也不例外。咱们客观地看看。

优点	缺点
代码结构清晰，容易理解	初次设计需要更多时间
修改影响范围小	接口设计不好会频繁改动
便于团队并行开发	模块间通信有额外开销
代码可复用性高	文件数量增多，管理成本上升
测试和调试更方便	过度拆分反而降低效率

优点方面，我感受最深的是可维护性。曾经维护过一个五年历史的老项目，因为当初做了良好的模块划分，接手时只花了一周就理清了所有逻辑。要是没有模块化，估计得一个月起步。

缺点方面，最怕的是过度设计。有些人一上来就搞十几个模块，每个模块就两三个函数。结果接口文件比实现文件还复杂，调用关系绕来绕去。嗯，这里要注意：模块不是越多越好，够用就行。

还有一个容易被忽略的问题：接口稳定性。模块之间的接口一旦确定，尽量不要频繁改动。否则你改一次，所有依赖这个模块的地方都得跟着改，那还不如不拆分。

1.4 模块化编程的核心逻辑

下面这张图展示了模块化编程的核心思想：

从这张图可以看出：

• 主程序只和模块调度层打交道
• 每个功能模块独立存在，互不干扰
• 所有模块都依赖底层的硬件抽象层
• 箭头方向表示依赖关系，依赖是单向的

单向依赖这一点很重要。我见过不少项目，模块 A 调用模块 B，模块 B 又回调模块 A，形成了循环依赖。这种代码改起来特别痛苦，牵一发而动全身。

1.5 什么时候该用模块化

不是所有项目都需要严格的模块化。我个人的经验是：

• 代码超过 2000 行：建议开始考虑模块化
• 多人协作：必须模块化，否则等着吵架吧
• 需要长期维护：模块化能省下大量维护时间
• 资源极度受限：比如只有 2KB RAM 的 MCU，适度模块化即可，别过度

说白了，模块化是一种投资。前期多花点时间设计，后期就能省下大把时间。我在一个智能家居项目中尝到了甜头——因为模块划分得好，后来客户要求增加新功能，我只加了一个新模块，改了 3 行代码就搞定了。

嗯，关于模块化编程的概述就聊到这里。记住一句话：好的模块化设计，是让每个模块都觉得自己是主角，但又离不开其他配角。

---

公众号:蓝海资料掘金营，微信 deep3321