C语言如何通过头文件#define封装接口且不暴露内部私有函数

结论 #

你期望的直接用公开宏展开调用私有函数f的方案无法实现，这是C语言编译/预处理模型的本质限制，无法通过#define/#undef等预处理指令绕过：
宏是在预处理阶段于调用方的编译单元内完全展开的，只要宏定义中出现了f，展开后的调用方代码就包含对f的直接调用，编译器处理调用方代码时必须能看到f的声明，必然会导致f暴露。

可行替代方案 #

你可以根据场景选择以下两种合规实现，都能满足f完全私有、同时保留宏/类宏的轻量特性：

方案1：保留原封装函数实现（最推荐）

这是C语言实现私有函数封装的标准做法，完全符合规范，性能也不比宏差：

1. 在f所在的.c文件中给f加上static修饰，确保它只在当前编译单元可见，完全对外隐藏：

// xxx.c 内部实现
static void f(int x, int y, int z){
    //bla bla bla
}

// 封装函数实现
void g(int x, int y, int z){
    f(x, 10, 10);
}
void h(int x, int y){
    f(x, y, 20);
}

2. 头文件中仅声明g和h的原型即可。
   现在的编译器（开启O2及以上优化、开启LTO的情况下）会自动把这种简单的封装函数调用内联掉，性能和宏没有任何差异，同时还有类型检查，比宏更安全。

方案2：头文件内置static版本的f+宏定义（适合f代码极短的场景）

如果你坚持要用宏实现，可以把f的实现放到头文件中，同时加static修饰，这样每个包含头文件的编译单元会生成一份f的本地副本，不会对外导出f的符号，完全满足私有要求：

// 头文件 xxx.h
#ifndef XXX_H
#define XXX_H

// static修饰的f仅当前编译单元可见，不会对外暴露
static void f(int x, int y, int z){
    //bla bla bla
}

#define h(x)       f(x, 10, 10)
#define g(x, y)    f(x, y, 20)

#endif

该方案的缺点是如果多个源文件包含头文件，会生成多份f的副本，占用更多存储空间，仅适合f本身代码量非常小的场景。

认知纠正 #

你提到的“用#define实现封装更符合通用规范”是错误认知，C语言中类函数宏没有类型检查，容易出现运算符优先级、参数重复计算等隐藏bug，现代C规范更推荐用static inline函数替代类函数宏实现轻量封装。

内容的提问来源于stack exchange，提问作者Mohammad Kholghi