[[deprecated]]需加在函数声明前，c++14+支持，可带说明字符串，须启用-wdeprecated-declarations警告，作用于可见声明而非定义，不适用于模板特化和宏。
![c++中的属性[[deprecated]]是什么？（如何标记过时的接口）](https://img.php.cn/upload/article/001/431/639/177147721292844.jpg)
怎么给函数加 [[deprecated]] 属性
直接在声明前加 [[deprecated]]，编译器会在调用处报警告。比如：
[[deprecated]] void old_api();
注意：必须写在声明（declaration）上，不是定义（definition）；头文件里声明了，所有包含它的源文件都会触发警告。
- 支持 C++14 及以上，老项目如果用 C++11 需升级标准或改用编译器扩展（如
__attribute__((deprecated))） - 不能加在模板特化上（
template [[deprecated]] void f<int>();</int>是非法的） - 类成员函数、重载函数、甚至 typedef 都能加，但 operator 重载要小心——有些编译器对
operator+这类隐式调用不总报警告
[[deprecated]] 的字符串参数怎么写才有效
可以带可选字符串说明原因和替代方案，比如：
[[deprecated("use new_api() instead")]] void old_api();
这个字符串只影响警告文案，不参与编译逻辑。但要注意：
立即学习“C++免费学习笔记（深入）”；
- 字符串内容不会被编译器校验，拼错、空格多、写成中文都没问题，但别留空（
[[deprecated("")]]在某些 clang 版本会静默失效） - MSVC 和 GCC/Clang 对字符串长度无硬限制，但过长可能截断显示；建议控制在 80 字以内
- 如果接口废弃分阶段（比如 v2.0 标记，v3.0 删除），字符串里写清版本号比写“即将移除”更可靠
为什么加了 [[deprecated]] 却没警告
常见原因不是属性写错了，而是编译器没开警告或调用方式绕过了检查：
- GCC/Clang 默认不开
-Wdeprecated-declarations，需显式启用（CMake 中加set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wdeprecated-declarations")） - MSVC 默认开启，但若项目设置了
/wd4996就会禁用该警告 - 通过函数指针调用、模板推导间接调用、或宏展开后调用，部分编译器可能不触发警告
- 头文件未被重新包含（比如修改了声明但没改 include 路径），旧的预编译头仍用老声明
和宏定义废弃方式比，[[deprecated]] 有什么实际区别
宏（比如 #define OLD_API() do { /*...*/ } while(0) + 注释）完全不提供类型安全和编译期检查，而 [[deprecated]] 是语言级机制：
- 它让 IDE 能高亮、跳转时标灰、自动补全时降权，宏做不到
- 链接时若符号被内联或优化掉，宏废弃信息彻底丢失，
[[deprecated]]的警告仍保留在调用点 - 无法用于宏本身（
[[deprecated]] #define BAD_MACRO 1语法错误），想废弃宏得靠#warning或条件编译 - 跨平台兼容性更好——不用为 GCC/Clang/MSVC 写三套属性宏
真正容易被忽略的是：属性只作用于「可见声明」。如果头文件里声明了 [[deprecated]]，但实现文件里又写了同名非 deprecated 定义，链接不会报错，但调用方看到的仍是带警告的声明。这种不一致得靠代码审查或 CI 检查工具抓。
