跨平台C库：调用未支持OS的函数时如何终止编译并提示？

要实现仅当未支持系统调用未实现函数时触发编译错误，且给出明确提示，可以借助C11的_Static_assert（静态断言）结合宏替换来实现，具体方案如下：

方案一：静态断言（推荐，C11及以上） #

头文件（比如example.h） #

#ifdef __linux__
// Linux平台下正常声明函数
void example(void);
#else
// 非Linux平台，将函数调用替换为静态断言，触发编译错误并给出提示
#define example() _Static_assert(0, "error: example() 仅支持Linux系统，当前系统未实现该函数")
#endif

源文件（比如example.c） #

#ifdef __linux__
void example(void) {
    // Linux平台下的具体实现
    // do stuff
}
#endif

效果 #

• Linux平台编译时：正常识别函数声明和定义，调用无问题。
• 非Linux平台未调用example()时：宏不会被展开，库可以正常编译。
• 非Linux平台调用example()时：编译阶段就会触发静态断言，输出你自定义的清晰错误提示，用户一眼就能明白是函数不支持当前系统。

方案二：兼容旧C标准（C99及以下） #

如果需要兼容不支持C11的编译器，可以用“未定义结构体”的方式触发编译错误，虽然提示不如静态断言直观，但也能达到效果：

头文件 #

#ifdef __linux__
void example(void);
#else
#define example() ((void)sizeof(struct example_not_supported_on_current_platform))
#endif

效果 #

非Linux平台调用该函数时，编译器会报错“未知类型名‘example_not_supported_on_current_platform’”，结合宏命名也能让用户理解问题原因。

为什么原来的写法不够好？ #

你之前的写法是把函数定义放在#ifdef __linux__中，非Linux平台下没有函数定义，当用户调用时会触发链接错误（提示“未定义的引用example”），这种错误信息不够直观，用户可能需要排查很久才意识到是函数不支持当前系统。而上面的方案能在编译阶段就给出明确的原因提示，避免用户困惑。

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