[[maybe_unused]]用于消除“未使用”警告，仅适用于变量、函数参数、静态成员等声明处，不支持返回类型、模板参数或-Wshadow场景，且非万能解决方案。

直接在形参或变量声明前加 [[maybe_unused]] 即可消除“未使用”警告，但它只对「本意就是不使用」的场景有效，不是万能胶水。

哪些地方能加 [[maybe_unused]]

它必须紧挨着声明，放在类型或标识符前面（不能插在中间），支持以下位置：

• 函数参数：void log([[maybe_unused]] int level, const std::string& msg)
• 局部变量：[[maybe_unused]] auto result = parse();
• 静态局部变量：[[maybe_unused]] static int counter = 0;
• 类内静态成员：struct S { [[maybe_unused]] static const int N = 42; };
• 结构化绑定：auto [x, [[maybe_unused]] y, z] = std::tuple{1, 2, 3};

不支持：模板参数、返回类型、typedef 或 using 别名本身（但别名定义的变量可以加）。

为什么 [[maybe_unused]] 对 -Wshadow 无效

-Wshadow 报的是变量遮蔽（比如参数名和局部变量同名），而 [[maybe_unused]] 只管「没被读/写」，不管名字冲突。你加了它，编译器照样报：

C++14

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

下载

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

void f(int x) {
    [[maybe_unused]] int x = 42; // error: declaration of 'x' shadows a parameter
}

这种情况下该改名、删重复声明，或用作用域花括号隔离，而不是硬加 [[maybe_unused]]。

常见误用陷阱

这些写法看似消除了警告，实则掩盖问题或根本无效：

• 给遮蔽变量加 [[maybe_unused]] —— 不解决遮蔽，也不抑制 -Wshadow
• 在 lambda 捕获列表里写 [x, [[maybe_unused]] y] —— 语法错误，属性必须放在 lambda 声明处：[=]([[maybe_unused]] int y) { ... }
• 用在函数返回值上：[[maybe_unused]] int foo() { return 0; } —— 属性不作用于返回类型，这里无效
• 跨平台项目中只测 GCC，忽略 MSVC 对 [[maybe_unused]] 的早期版本支持不全（MSVC 2017 起才稳定支持）

真正难处理的从来不是加不加属性，而是判断「这个变量/参数到底该不该存在」——如果连意图都不清晰，加再多属性也救不了逻辑漏洞。