大型代码库中，GCC下无需前置声明能否弃用C/C++函数？

针对大型代码库中弃用函数但不想修改源码、避免前置声明痛点的需求，以下是几种兼容GCC/Clang/MSVC的实用方案：

方案1：宏重定义+条件编译（避免系统头文件冲突） #

通过宏重定义目标函数，在调用时触发弃用警告，同时利用编译器的系统头文件标记（如__SYSTEM_HEADER__）避免影响系统库中的函数声明。这种方法无需完整的函数前置声明，仅需简单的宏定义：

#ifdef __GNUC__
#  define DEPRECATE_WARNING(msg) _Pragma(GCC warning msg)
#elif defined(_MSC_VER)
#  define DEPRECATE_WARNING(msg) __pragma(message(msg))
#else
#  define DEPRECATE_WARNING(msg)
#endif

// 仅在用户代码中生效，跳过系统头文件
#ifndef __SYSTEM_HEADER__
#  define strcat(dest, src) \
    (DEPRECATE_WARNING("'strcat' is deprecated - use strlcat or a safer alternative"), strcat(dest, src))
#endif

注意事项： #

• 该方案对函数直接调用生效，但如果代码中存在取函数地址（如void (*fn)(...) = strcat;）的场景，宏不会触发警告。
• __SYSTEM_HEADER__是GCC/Clang的内置宏，系统头文件会自动定义它；MSVC可配合_CRT_BUILD等宏区分系统头文件，或者用路径判断辅助过滤。

方案2：链接器级别的拦截与警告 #

利用链接器的包装功能（GCC/Clang的--wrap选项，MSVC的/alternatename），将目标函数重定向到一个带弃用警告的包装函数，无需修改源码或添加前置声明：

GCC/Clang实现： #

1. 编写一个包装函数（可放在单独的.c文件中）：

#include <stdio.h>
#include <string.h>

__attribute__((deprecated)) char *__wrap_strcat(char *dest, const char *src) {
    fprintf(stderr, "Warning: 'strcat' is deprecated - use safer alternative\n");
    return __real_strcat(dest, src);
}

2. 编译时添加链接器选项：-Wl,--wrap=strcat

MSVC实现： #

1. 编写包装函数：

#include <stdio.h>
#include <string.h>

__declspec(deprecated) char *strcat_wrap(char *dest, const char *src) {
    printf("Warning: 'strcat' is deprecated - use safer alternative\n");
    return strcat(dest, src);
}

2. 链接时添加选项：/alternatename:strcat=strcat_wrap

优势： #

• 对所有调用场景生效，包括取函数地址的情况。
• 无需处理头文件依赖或类型匹配问题。

方案3：编译器内置属性的简化声明（规避类型依赖） #

如果必须使用-include+前置声明的方式，可通过简化类型声明规避头文件依赖问题。例如对于strncpy，无需引入stddef.h定义size_t，直接用unsigned int替代（只要与实际类型兼容即可，编译器会自动匹配）：

#ifdef __GNUC__
#  define DEPRECATE_ATTR __attribute__((deprecated))
#elif defined(_MSC_VER)
#  define DEPRECATE_ATTR __declspec(deprecated)
#else
#  define DEPRECATE_ATTR
#endif

#ifdef __cplusplus
extern "C" {
#endif

DEPRECATE_ATTR
char *strncpy(char *, const char *, unsigned int);

#ifdef __cplusplus
}
#endif

说明： #

• 只要简化类型与实际函数的参数类型兼容（如unsigned int和size_t在多数平台上是等价的），编译器就会识别为同一个函数，触发弃用警告。
• 这种方法避免了引入额外头文件，减少了对源码的间接影响。

附：兼容GCC/Clang/MSVC的strcat标准弃用头文件（原示例）

#ifdef __GNUC__
#  define _DEPRECATE_ATTR __attribute__((deprecated))
#elif defined(_MSC_VER)
#  define _DEPRECATE_ATTR __declspec(deprecated)
#else
#  define _DEPRECATE_ATTR
#endif

#ifdef __cplusplus
#  define _DEPRECATE_CXX_NOEXCEPT noexcept
#else
#  define _DEPRECATE_CXX_NOEXCEPT
#endif
#ifdef __cplusplus
extern "C" {
#endif

_DEPRECATE_ATTR
extern char *strcat(char *, const char *)
#ifndef _MSC_VER
    _DEPRECATE_CXX_NOEXCEPT
#endif
    ;

#ifdef __cplusplus
};
#endif

注意：#pragma GCC poison方案虽能禁用函数，但通过-include全局注入时会触发系统头文件中的函数声明错误，因此不推荐全局使用，仅适合在特定源码文件中局部禁用。

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