[[nodiscard]] 应用于返回值重要的函数，如错误码、资源句柄或状态对象，防止忽略返回值导致 bug。例如 bool write_data() 标记后，调用时不检查返回值会触发编译警告。可直接用于函数声明，C++20 支持添加说明字符串，也可标记类或枚举类型，使所有返回该类型的函数自动生效。用于工厂函数、资源管理或操作状态返回时，能提升代码健壮性，配合 std::optional 等类型强化“必须处理”语义。

[[nodiscard]] 是 C++17 引入的一个属性，用来提示编译器：某个函数的返回值不应该被忽略。如果调用者调用了带有 [[nodiscard]] 的函数但没有使用其返回值，编译器会发出警告。

C++14

C++14 对 C++11 的修正与增强版本，适合旧系统维护和较老工具链兼容。

下载

这个特性主要用于防止程序员无意中忽略关键的返回信息，比如错误码、状态对象或资源句柄，从而避免潜在的 bug。

什么时候该用 [[nodiscard]]

适用于那些返回值具有重要意义的函数，例如：

• 返回操作是否成功的布尔值
• 返回错误码或异常状态的枚举类型
• 返回需要手动释放的资源（如智能指针包装的对象）
• 工厂函数返回新创建的对象实例

例如，一个文件写入函数可能这样定义：

[[nodiscard]] bool write_data(const std::string& data);

如果调用时写成 write_data("hello"); 而不检查返回值，编译器就会警告：“返回值被忽略”。

如何使用 [[nodiscard]]

可以直接加在函数声明前：

[[nodiscard]] int calculate_result();

也可以带一个字符串说明原因（C++20 起支持）：

[[nodiscard("返回的是资源句柄，必须处理")]] 
ResourceHandle acquire_resource();

这样编译器警告时可能会显示这条消息，帮助开发者理解为何不能忽略。 它还能用于类和枚举类型，表示用这类类型作为函数返回值时也不应被忽略：

[[nodiscard]] struct OperationResult {
    bool success;
    int code;
};

所有返回 OperationResult 的函数都会自动带上 [[nodiscard]] 效果。

实际开发中的好处

在大型项目中，很容易不小心写出这样的代码：

open_file("config.txt"); // 忘记检查是否打开成功

加上 [[nodiscard]] 后，这类疏忽会在编译阶段就被发现。 尤其适合与现代 C++ 风格配合使用，比如用 std::expected 或 std::optional 返回结果的函数，它们本身就表达了“必须处理”的语义。 基本上就这些。合理使用 [[nodiscard]] 能提升代码健壮性，让接口意图更明确。