[[maybe_unused]] 是 C++17 引入的属性，须置于变量或参数声明前，用于标记可能未使用的实体以抑制警告；位置错误或编译器不支持则无效。

直接加 [[maybe_unused]] 就行，但必须放在声明前、且编译器得支持 C++17。

变量声明前加属性才生效

编译器只认声明位置上的 [[maybe_unused]]，写在后面或注释里都没用。它不是修饰符，是声明的一部分。

• [[maybe_unused]] int x = 42; ✅ 正确
• int [[maybe_unused]] x = 42; ❌ 大多数编译器不接受（语法错误）
• int x = 42; [[maybe_unused]] ❌ 完全无效

函数参数也能用，尤其适配回调接口

当函数签名由外部约定（比如库回调、信号槽、虚函数重写）强制要求，但你实际只用其中几个参数时，[[maybe_unused]] 比 (void)param; 更清晰、更安全。

• void onEvent([[maybe_unused]] int id, const std::string& msg) { std::cout
• MSVC 会报 C4100，GCC/Clang 报 -Wunused-parameter，加了属性后全部静默
• 比在函数体开头写 (void)id; 更早起作用——警告在解析声明阶段就抑制了，不依赖语句执行

静态成员、类型别名、结构化绑定都支持

这个属性适用范围比很多人想的更广，不只是局部变量。

C++ Code Review Master

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

下载

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

• 静态成员：struct S { [[maybe_unused]] static const int Default = 1024; };
• 类型别名：using [[maybe_unused]] Handle = void*;（虽然少见，但合法）
• 结构化绑定：auto [x, [[maybe_unused]] y, z] = std::tuple{1, 2, 3};
• 注意：不能用于模板参数、lambda 捕获列表、返回类型，这些地方语法不允许

和 (void)x; 或 static_cast<void>(x); 的关键区别

老式“丢弃”写法是在语句级压制警告，而 [[maybe_unused]] 是在声明级表达意图，两者层级不同。

• (void)x; 要求变量已定义，且只能出现在函数体内；[[maybe_unused]] 可用于全局、命名空间、类内等任意声明上下文
• static_cast<void>(x); 在某些旧编译器上可能触发 -Wold-style-cast 新警告
• [[maybe_unused]] 不产生任何运行时开销，也不改变类型或值，纯粹是给编译器看的元信息
• 如果用了 [[nodiscard]] 函数返回值，再用 [[maybe_unused]] 声明接收变量，能同时满足“不忽略返回值”和“允许变量未被后续使用”两个约束

最容易被忽略的是兼容性底线：GCC ≥ 7、Clang ≥ 5、MSVC ≥ 2017（即开启 /std:c++17），低于这些版本会直接忽略该属性——看起来没警告，其实是没生效，而不是静默成功。