4. 函数设计：让代码像积木一样清晰
函数是C语言的灵魂。我见过太多项目，代码动辄几千行挤在一个函数里，调试起来简直要命。今天咱们聊聊怎么把函数设计得干净利落。
核心原则：一个函数只做一件事，做好一件事。
4.1 函数长度控制：别让函数变成“大泥球”
我个人习惯，一个函数尽量控制在50行以内。超过这个数，我就开始警觉了。你想想看，一个200行的函数，你读起来是不是得来回翻页？维护起来更是噩梦。
什么时候该拆分？
- 函数内部出现明显的“段落感”——比如初始化、处理、清理三个部分
- 一段逻辑可以被独立描述（“这部分是在做校验”）
- 代码缩进超过3层
我在项目中遇到过这样一个案例：一个串口驱动函数写了400行，里面混杂着硬件初始化、数据解析、错误重传、日志打印。后来我把它拆成6个小函数，每个20-50行。结果呢？bug定位时间缩短了60%。
小技巧：写函数时先写注释骨架，再填代码。如果注释超过5行，就该拆了。
4.2 参数传递：值传递 vs 指针传递
这是C语言面试的常客，但实际项目中很多人用错。说白了，就两条规则：
| 传递方式 | 适用场景 | 示例 |
|---|---|---|
| 值传递 | 基础类型（int, char, float等），且不需要修改原值 | int add(int a, int b) |
| 指针传递 | 大型结构体、数组、需要修改原值、动态分配的内存 | void process(struct data *p) |
避坑指南：我曾经见过有人把100字节的结构体用值传递，每次调用都要拷贝一次。在循环里调用1000次，性能直接崩了。记住：超过8字节的结构体，用指针传递。
注意：指针传递虽然高效，但要注意空指针检查。我习惯在函数开头加一句：
if (p == NULL) return -1;4.3 返回值设计：让调用者知道发生了什么
返回值是函数和调用者之间的“契约”。我建议遵循以下原则：
- 成功/失败：返回0表示成功，负数表示错误码
- 查询类函数：返回实际值，用特殊值（如-1）表示异常
- 布尔判断：返回0或1，用bool类型更清晰
// 好的设计
int sensor_read(float *value) {
if (sensor == NULL) return -1;
*value = hardware_read();
return 0;
}
// 糟糕的设计
int sensor_read() {
// 返回值既表示状态又表示数据，容易混淆
return hardware_read(); // 0-100是数据，-1是错误？
}嗯，这里要注意：不要用返回值同时表示数据和状态。我见过一个函数返回int，正数表示数据，负数表示错误码，结果调用方经常忘记检查符号。
4.4 内联函数：性能与代码体积的平衡
内联函数是个好东西，但别滥用。说白了，它就是把函数调用替换成函数体，省去了调用开销。
什么时候用？
- 函数体很小（2-5行）
- 被频繁调用（比如在循环里）
- 对性能敏感的场景（中断处理、实时控制）
// 适合内联
static inline int min(int a, int b) {
return (a < b) ? a : b;
}
// 不适合内联
static inline void complex_calculation(int *data, int len) {
// 50行代码... 内联会导致代码膨胀
}我的经验：在嵌入式系统中，内联函数要谨慎。我曾经把一个20行的函数标记为inline，结果代码体积增加了30%，反而因为缓存命中率下降导致性能变差。记住：inline只是建议，编译器有权忽略。
4.5 函数指针：让代码活起来
函数指针是C语言的“高阶玩法”。它让你能把函数当作参数传递，实现回调、状态机、插件化设计。
典型应用场景：
- 回调函数（定时器、中断、事件处理）
- 状态机（用函数指针数组实现状态跳转）
- 策略模式（不同算法通过函数指针切换）
// 定义函数指针类型
typedef int (*operation_t)(int, int);
// 具体实现
int add(int a, int b) { return a + b; }
int sub(int a, int b) { return a - b; }
// 使用函数指针
int calculate(operation_t op, int x, int y) {
return op(x, y);
}
// 调用
int result = calculate(add, 5, 3); // 8警告：函数指针用不好就是灾难。我曾经接手过一个项目，函数指针被嵌套了3层，调用链根本看不清。建议：
- 用typedef给函数指针起个清晰的名字
- 不要超过2层间接调用
- 在注释里写明回调的触发时机
知识体系总览
下面这张图总结了函数设计的核心要点，我把它画成了一张思维导图：
函数设计没有银弹，但遵循这些原则，你的代码会越来越像“艺术品”。我每次review代码，第一件事就是看函数长度和参数设计。这两关过了，代码质量基本就有保障了。