[[nodiscard]]用于提示编译器函数返回值不应被忽略，若忽略则发出警告，提升代码安全与维护性，常用于错误状态、资源管理等关键操作，防止未处理的返回值导致逻辑错误或未定义行为。

在C++17中引入的 [[nodiscard]] 是一种属性（attribute），用于提示编译器某个函数的返回值不应被忽略。如果调用者忽略了带有该属性的函数的返回值，编译器会发出警告。这个特性主要用于提升代码的安全性和可维护性，尤其在处理错误状态、资源管理或关键操作结果时非常有用。

提高代码安全：防止忽略重要返回值

很多函数的返回值包含关键信息，比如操作是否成功、获取的状态码、分配的资源句柄等。如果不检查这些返回值，程序可能在出错后继续执行，导致未定义行为或逻辑错误。

使用 [[nodiscard]] 可以强制开发者关注这些返回值，避免“调用了函数但没处理结果”的常见问题。

例如：

一个文件打开函数返回操作是否成功：

立即学习“C++免费学习笔记（深入）”；

[[nodiscard]] bool openFile(const std::string& filename);

如果调用时写成：openFile("config.txt"); 而没有检查返回值，编译器会警告：“忽略 [[nodiscard]] 函数的返回值”。这促使开发者写成：

if (!openFile("config.txt")) { /* 处理错误 */ }

C++ Code Review Master

组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。

下载

应用于自定义类型和标准库

[[nodiscard]] 不仅可用于普通函数，还可用于类成员函数、构造函数（C++20起）以及枚举类型。标准库中许多新加入的函数也使用了该属性，如 std::optional::value()、std::future::get() 等。

你也可以在自己的项目中广泛使用它：

• 标记返回错误码的函数
• 包装资源获取操作的结果
• 任何“调用即需关注结果”的接口

示例：自定义结果类型

struct [[nodiscard("必须检查操作结果")]] Result {
  bool success;
  std::string message;
};

这里还使用了带字符串说明的版本，编译器警告时会显示提示信息。

实际应用建议

在团队开发或大型项目中，合理使用 [[nodiscard]] 能显著减少因忽略返回值引发的bug。但也要注意不要滥用，否则会导致警告泛滥，降低其有效性。

建议在以下情况使用：

• 函数失败会影响后续逻辑
• 返回的是新生成的对象或状态
• 接口设计上要求调用者必须做出响应

对于纯计算型函数（如加法）、无副作用的访问器，一般不需要加此属性。

基本上就这些。正确使用 [[nodiscard]] 是一种轻量级但高效的静态检查手段，帮助你在编译期发现潜在问题，提升C++代码的健壮性。不复杂但容易忽略。