c++17引入的[[nodiscard]]和[[maybe_unused]]属性用于提升代码质量和可读性。[[nodiscard]]用于提醒开发者不要忽略关键返回值，适用于函数、枚举或结果结构体，如std::optional::value()；若忽略返回值且编译器支持相关选项（如-wunused-result），则会触发警告。[[maybe_unused]]则用于抑制未使用变量或函数的警告，适用于调试代码、条件编译或参数占位符，如调试函数、release构建中未使用的变量或回调中未用参数。两者虽不影响程序行为，但有助于减少误用和冗余警告。
![现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法](https://img.php.cn/upload/article/000/969/633/175168308224711.png)
C++17 开始引入了属性说明符（Attribute Specifiers），允许开发者以更标准的方式给代码添加元信息。其中 [[nodiscard]] 和 [[maybe_unused]] 是两个比较实用、使用频率较高的属性，它们分别用于提示编译器在特定情况下给出警告。
![现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法](https://img.php.cn/upload/article/000/969/633/175168308275281.png)
下面来看看这两个属性的具体用途和使用方式。
![现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法](https://img.php.cn/upload/article/000/969/633/175168308357086.png)
[[nodiscard]]：提醒你不要忽略返回值
这个属性最常见的用途是加在函数或者枚举类型上，告诉调用者“这个返回值你不应该忽略”。
立即学习“C++免费学习笔记（深入）”；
使用场景：
- 函数执行有副作用或返回关键数据，比如错误码、结果状态等。
- 如果调用者忽略了返回值，可能造成 bug，例如资源未释放或状态判断缺失。
[[nodiscard]] int compute_value(); // 调用时如果忽略返回值，有些编译器会报警告 compute_value(); // 可能触发 warning: ignoring return value
常见做法：
-
用于封装操作结果的类或结构体：
![现代C++中的属性说明符有哪些 [[nodiscard]] [[maybe_unused]]用法](https://img.php.cn/upload/article/000/969/633/175168308471418.png)
[[nodiscard]] struct Result { bool success; std::string message; }; 用于标准库中的一些函数，如
std::optional<T>::value()也有[[nodiscard]]属性。
注意：并不是所有编译器都会默认开启这个检查，需要配合合适的编译选项（如 -Wunused-result）才能生效。
[[maybe_unused]]：告诉编译器这个变量/函数可能不被使用
有时候我们定义了一个变量、函数或参数，但只在某些条件下才使用它，比如调试信息、平台差异处理等。这时候为了避免编译器报出“unused variable”之类的警告，就可以加上这个属性。
使用示例：
[[maybe_unused]] void debug_log(const std::string& msg) {
// 仅在调试构建中使用
std::cout << msg << std::endl;
}也可以用在变量上：
void func(int flag) {
[[maybe_unused]] int debug_flag = flag;
// debug_flag 可能在 release 构建中没被用到
}适用情况包括：
- 调试函数或变量
- 条件编译中的备用代码
- 参数占位符（如回调函数中未使用的参数）
void callback([[maybe_unused]] int event_type, int data) {
// event_type 某些情况下可能不用
}小结
-
[[nodiscard]]提醒不要忽略返回值，适合用于重要函数或结果类型。 -
[[maybe_unused]]避免无用变量/函数的警告，适合用于调试或条件分支中。
这两个属性虽然不能改变程序行为，但可以提高代码可读性和安全性，同时减少不必要的编译警告。
基本上就这些，用起来也不复杂，但在实际项目中很容易被忽略。
