21、代码复用安全：宏定义陷阱、内联函数安全、回调函数安全、函数指针类型安全

代码复用，听起来很美对吧？

但我在嵌入式这行干了十几年，见过太多因为“复用”而翻车的案例。说白了，复用不是简单的复制粘贴，更不是把一段代码用宏包一下就完事。今天咱们就聊聊代码复用中的四个安全雷区：宏定义、内联函数、回调函数、函数指针。每个我都踩过坑，希望你能绕过去。

21.1 宏定义陷阱：你以为的“常量”其实是个炸弹

宏定义是C语言的老祖宗留下的遗产。它本质上是文本替换，不是真正的变量或函数。这个区别，就是所有问题的根源。

先看个例子：

#define SQUARE(x) x * x

// 调用
int a = 5;
int result = SQUARE(a++);  // 你期望的是 25，实际呢？

展开后变成 a++ * a++。a被自增了两次，结果是未定义的。我在项目中遇到过类似问题，调试了一整天才发现是宏搞的鬼。从那以后，我给自己定了个规矩：宏参数如果可能带副作用，必须加括号，并且只求值一次。

正确的写法：

#define SQUARE(x) ({ \
    __typeof__(x) _x = (x); \
    _x * _x; \
})

或者干脆用内联函数替代。

21.2 内联函数安全：性能与代码膨胀的平衡

内联函数（inline）是C99引入的。它看起来像函数，但编译器可能会把它展开成内嵌代码，省去函数调用的开销。

听起来很美？但有两个坑：

• 代码膨胀：内联函数每调用一次，就复制一份代码。如果内联函数很大，或者被频繁调用，代码体积会急剧膨胀。在嵌入式系统里，Flash空间可是寸土寸金。
• 递归问题：内联函数不能递归。编译器会忽略递归函数的内联请求。

我曾经在一个项目里，把一个大函数标记为inline，结果编译出来的固件直接超了Flash大小。嗯，从那以后我学会了：内联只适合小函数，一般不超过10行。

安全使用内联函数的几个原则：

原则	说明
函数体要小	建议不超过10行，否则内联收益不大
避免递归	编译器会忽略递归函数的内联请求
注意static	内联函数建议加static，避免链接冲突
调试友好	内联函数在调试时可能看不到调用栈，建议调试阶段先关掉内联优化

21.3 回调函数安全：别让你的函数指针变成野指针

回调函数是嵌入式系统中非常常见的模式。比如定时器回调、中断回调、事件驱动框架等。但回调函数的安全问题，往往出在“生命周期”上。

你想想看：你注册了一个回调函数，但注册之后，那个函数所在的模块被卸载了，或者函数所在的上下文被销毁了。这时候回调触发，就是典型的“野指针”调用。

安全回调的推荐做法：

// 回调函数类型定义
typedef void (*timer_callback_t)(void *arg);

// 注册回调时，同时保存上下文
typedef struct {
    timer_callback_t callback;
    void *arg;
} timer_callback_entry_t;

// 注销时，必须清空
void timer_unregister(int timer_id) {
    timer_table[timer_id].callback = NULL;
    timer_table[timer_id].arg = NULL;
}

另外，回调函数内部也要注意：不要做耗时操作。回调通常是在中断或事件循环中调用的，如果回调里做大量计算或阻塞操作，整个系统都会被拖慢。

21.4 函数指针类型安全：类型系统是你的朋友

函数指针是C语言里最灵活、也最容易出错的特性之一。类型不匹配的函数指针赋值，编译器可能只给个警告，甚至什么都不说。

看这个例子：

int add(int a, int b) {
    return a + b;
}

void *bad_ptr = add;  // 隐式转换，危险！

这种写法，编译器可能只给个警告。但运行时一旦调用，栈帧完全错乱，后果不堪设想。

我个人的习惯是：函数指针必须显式类型转换，并且用typedef定义清晰。

// 定义清晰的函数指针类型
typedef int (*math_op_t)(int, int);

// 赋值时显式转换
math_op_t op = (math_op_t)add;

// 调用
int result = op(3, 4);

另外，函数指针数组也是常见的陷阱。数组里的每个元素类型必须完全一致。如果混入不同类型的函数指针，调用时参数传递会乱套。

21.5 知识体系总览

下面这张图，帮你理清本章的核心逻辑：

这张图把四个知识点串起来了。你看，每个分支都有自己独特的陷阱，但核心思想是一致的：复用不是简单的复制粘贴，而是需要精心设计的安全机制。

好了，关于代码复用安全，今天就聊到这儿。记住：宏定义要小心参数求值，内联函数要控制大小，回调函数要管理生命周期，函数指针要保证类型安全。这四个点，每一个都能让你的代码更健壮。

---