clang报unused parameter警告的常见场景是函数参数声明后未被读、写或取地址，如回调函数中仅使用部分参数；应优先用[[maybe_unused]]标记（c++17起），其次用__attribute__((unused))，避免全局禁用该警告。
Clang报unused parameter警告的常见场景
这类警告通常出现在函数定义中，参数被声明但整段函数体里没读、没写、没取地址，比如回调函数签名固定但实际只用其中几个参数，或者接口层预留参数未来扩展。Clang（包括GCC）在启用 -Wall 或 -Wunused-parameter 时会触发：warning: unused parameter 'ctx' [-Wunused-parameter]。
优先用[[maybe_unused]]标记（C++17起）
这是最现代、最明确的写法，语义清晰且跨编译器兼容（Clang/GCC/MSVC都支持）。它告诉编译器：“这个参数不用，是我有意为之”。
- 必须紧贴参数声明，不能放在函数返回类型或前面
- 对C代码无效，仅限C++
- 示例：
void handler(int code, [[maybe_unused]] void* user_data) { /* 只用了code */ }
用__attribute__((unused))抑制（C/C++通用）
Clang和GCC都支持该属性，适用于C代码或需兼容老C++标准的项目。注意位置：它要跟在参数名后面，不是类型前面。
Clang 22.1.3
下载
Clang 22.1.3 Windows 64 位历史版本安装包，适合旧项目兼容、LLVM/Clang 工具链回退、编译行为对比、链接问题复现和 C/C++ 构建环境维护。
- 错误写法：
void fn(__attribute__((unused)) int x)—— 某些版本会忽略或报错 - 正确写法：
void fn(int x __attribute__((unused))) - 宏封装更安全：
#define UNUSED(x) x __attribute__((unused))，然后写void fn(UNUSED(int x))
避免全局关掉-Wunused-parameter
虽然加 -Wno-unused-parameter 能一键屏蔽，但会掩盖真正疏漏——比如本该用却忘了用的参数，或重构后残留的冗余参数。这种“一刀切”在大型工程里容易埋雷。
- 局部禁用更可控：
#pragma GCC diagnostic push+#pragma GCC diagnostic ignored "-Wunused-parameter"（仅限该函数块） - 第三方头文件引入的警告，才考虑在构建系统里针对性关闭，而非整个项目
- CI流程中建议保留该警告，作为代码审查的一道基础过滤
真正难处理的不是语法怎么写，而是判断“这个参数到底该不该存在”：如果只是占位，就用 [[maybe_unused]] 或 __attribute__((unused)) 显式承认；如果它本该参与逻辑却被遗漏，那警告就是在救你。
