如何在多编译器环境下弃用C99库头文件并触发警告？

要给C99库中被弃用的头文件添加跨编译器的警告提示，核心思路是优先利用主流编译器的扩展指令，同时为小众编译器提供降级兼容方案，确保既不触发编译错误，又能让用户收到明确的弃用提示。

1. 主流编译器的直接实现 #

GCC、Clang、MSVC、Intel编译器在C99模式下都原生支持#warning扩展，可直接通过条件编译启用：

#if defined(__GNUC__) || defined(__clang__) || defined(_MSC_VER) || defined(__INTEL_COMPILER)
#warning "警告：<my_deprecated_header.h> 已被弃用，后续版本将移除，请使用 <new_header.h> 替代"
#endif

2. 小众编译器的兼容处理 #

针对Sun Studio这类使用#message而非#warning的编译器，单独适配：

#elif defined(__SUNPRO_C)
#message "警告：<my_deprecated_header.h> 已被弃用，后续版本将移除，请使用 <new_header.h> 替代"

3. 极端场景的降级方案 #

对于完全不支持警告指令的编译器，用未使用的静态变量触发隐含警告（部分编译器可能不提示，但不会导致编译失败）：

#else
static const char DEPRECATED_MY_HEADER_WARNING[] __attribute__((unused)) = 
    "警告：<my_deprecated_header.h> 已被弃用，后续版本将移除，请使用 <new_header.h> 替代";
#endif

完整兼容模板 #

将以上逻辑整合，形成覆盖绝大多数编译器的头文件模板：

#ifndef DEPRECATED_MY_HEADER_H
#define DEPRECATED_MY_HEADER_H

// 弃用警告逻辑
#if defined(__GNUC__) || defined(__clang__) || defined(_MSC_VER) || defined(__INTEL_COMPILER)
#warning "警告：<my_deprecated_header.h> 已被弃用，将在未来版本中移除，请使用 <new_header.h> 替代"
#elif defined(__SUNPRO_C)
#message "警告：<my_deprecated_header.h> 已被弃用，将在未来版本中移除，请使用 <new_header.h> 替代"
#else
static const char DEPRECATED_MY_HEADER_WARNING[] __attribute__((unused)) = 
    "警告：<my_deprecated_header.h> 已被弃用，将在未来版本中移除，请使用 <new_header.h> 替代";
#endif

// 原头文件的原有代码内容...

#endif // DEPRECATED_MY_HEADER_H

额外提示 #

• 警告信息中务必明确替代头文件或迁移方案，降低用户迁移成本；
• 若需要更严格的管控，可配合__attribute__((deprecated))标记头文件内的函数/类型，从符号层面强化弃用提示；
• MSVC 2015及以后版本已支持#warning，旧版本可替换为__pragma(message("警告内容"))实现相同效果。

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