c++17起[[nodiscard]]可接字符串字面量作为警告提示文案，仅用于编译器输出，不改变语义；需c++17+、clang 10+/gcc 10+/msvc 2022 17.5+支持，旧版可能报错或忽略。
![c++中的[[nodiscard]]原因字符串是什么？（如何给弃用api添加提示）](https://img.php.cn/upload/article/001/431/639/177138008386948.jpg)
为什么 [[nodiscard]] 后面能跟字符串？
因为 C++17 允许在 [[nodiscard]] 属性中加一个字面量字符串参数，它不会影响语义，只作为编译器警告时的提示文案。这个字符串不是“原因”，而是“建议替代方案或上下文说明”——编译器（如 Clang/GCC）会在触发 [[nodiscard]] 警告时把它一并打出来，帮调用者快速理解意图。
常见错误现象：写了 [[nodiscard]] "use foo_v2() instead"，但 MSVC 2019 或更早版本不识别该语法，直接报错 error C7626: anonymous union cannot have base classes（其实是误解析属性导致的连带错误）。
- 仅 C++17 及以上标准支持带字符串的写法；C++14 只支持无参
[[nodiscard]] - 字符串必须是字符串字面量（
"..."），不能是宏、变量或std::string - Clang 10+、GCC 10+、MSVC 2022 17.5+ 才稳定支持；旧版 MSVC 会静默忽略字符串或报错
怎么给弃用 API 加 [[nodiscard]] 提示？
典型场景是函数返回重要值（比如错误码、新分配对象、临时句柄），但被调用者习惯性忽略返回值——这时候加 [[nodiscard]] 并附提示，比单纯加 [[deprecated]] 更有效：后者只警告“别用了”，前者强调“用了就别扔”。
实操建议优先组合使用：
立即学习“C++免费学习笔记（深入）”；
- 对已弃用但尚未移除的函数，同时加
[[deprecated("use bar_safe() instead")]]和[[nodiscard("check return value!")]] - 字符串内容要具体，避免空泛的
"please check"，推荐指向替代接口或关键动作，比如"call close() before exit" - 如果函数本身已标记
[[nodiscard]]，又想额外提示弃用，字符串里就别重复“don’t ignore”，而应写清迁移路径
示例：
[[deprecated("use encrypt_v2() with AEAD mode"), nodiscard("encrypt_v2() returns error code")]]
std::vector<uint8_t> encrypt(const std::vector<uint8_t>& data);
[[nodiscard]] 字符串在哪些地方会被忽略？
它只是提示增强，不改变任何行为：编译器可以自由选择是否显示该字符串，链接器和运行时不感知，IDE 也不保证解析。最常被忽略的场景有三个：
- 使用
-Wno-unused-result（GCC/Clang）或/wd4834（MSVC）关掉未使用返回值警告，字符串自然消失 - 函数返回类型是
void或引用类型（T&），[[nodiscard]]本身无效，字符串也就没意义 - 在模板实例化中，若原始声明没写字符串，特化版本即使补上，多数编译器也不会读取（Clang 15 仍存在此限制）
兼容旧编译器的写法怎么处理？
如果你的项目还要支持 GCC 9、MSVC 2019 这类不认字符串的编译器，不能直接写 [[nodiscard("...")]]，否则构建失败。得用宏封装：
- 定义类似
#define NODISCARD_MSG(msg) [[nodiscard msg]]是错的——预处理器无法拆解属性参数 - 正确做法是条件编译：
#if __cpp_impl_nodiscard >= 201907L判断标准支持度，或用#ifdef __clang__+ 版本检查 - 更稳妥的是统一用无参
[[nodiscard]]，把详细提示挪到 Doxygen 注释或头文件注释里——毕竟字符串只是锦上添花，核心约束靠属性本身
真正容易被忽略的点是：字符串提示依赖编译器警告开启，而很多 CI 流程默认关闭 -Wunused-result 类警告。没开警告，再好的字符串也白搭。
