应使用__attribute__((unused))精准标记有意未用的变量或参数，语义明确且兼容gcc/clang；避免用#pragma粗粒度压制，以防掩盖真实问题。
Clang（LLVM 的 C/C++ 前端）默认启用 -Wunused-variable 和 -Wunused-parameter 等警告，这类提示本身是有价值的，但对有意保留的变量（如占位参数、条件编译分支中的暂未启用变量），直接删掉会破坏接口或可读性。正确做法不是关警告，而是用明确、可维护的方式告诉编译器“我知道它没被用，但我留着有原因”。
怎么用 __attribute__((unused)) 标记变量
这是最直接、最标准的 LLVM/Clang 兼容方式，GCC 也支持，语义清晰且不干扰优化。
- 加在变量声明前：
int __attribute__((unused)) debug_flag = 0; - 用于函数参数（尤其回调接口中预留的 future 参数）：
void handler(int event, void* __attribute__((unused)) user_data) { ... } - 注意：不能写成
__attribute__((unused)) int x;（顺序错），必须紧贴变量名或参数名左侧 - 宏封装更安全（避免拼写错误）：
#define UNUSED(x) __attribute__((unused)) x，然后写int UNUSED(debug_counter);
(void)var; 在函数体内“使用”变量
适用于局部变量，尤其调试阶段临时注释掉逻辑时。它不产生代码，仅向编译器发出信号。
- 写法简单：
int tmp = compute(); (void)tmp; - 必须放在函数作用域内，不能用于全局变量或参数声明处
- 注意：若变量是 volatile（如硬件寄存器映射），
(void)不足以抑制警告，此时必须用__attribute__((unused))或实际读取一次 - Clang 会识别该模式并静默，但某些静态分析工具（如 clang-tidy）可能仍报
cppcoreguidelines-pro-bounds-array-to-pointer-decay类似误报，需单独禁用
为什么别用 #pragma GCC diagnostic ignored "-Wunused-variable"
这个指令在 Clang 中虽能工作，但属于粗粒度压制，隐患明显：
- 它会关闭当前作用域（甚至整个文件）所有同类警告，可能掩盖真正疏漏的未使用变量
- Clang 对 pragma 支持不如 GCC 稳定，跨版本易出兼容问题
- 团队协作时，他人无法快速判断某处警告是“已知忽略”还是“被意外屏蔽”
- CI 流水线若开启
-Werror，这种 pragma 可能导致构建失败（Clang 某些版本对 ignored pragma 处理不一致）
工程级建议：让警告保持有效，只精准标注
真正健壮的项目不会全局降级警告等级，而是把 -Wunused 当作质量守门员：
- 在
CMakeLists.txt中坚持启用：target_compile_options(my_target PRIVATE -Wall -Wextra -Wunused) - 对第三方头文件或生成代码，用
add_compile_options(-Wno-unused)局部禁用，而非污染主代码 - CI 阶段强制
-Werror=unused（注意不是全量-Werror），确保每个__attribute__((unused))都是显式决策 - 定期 grep 项目中的
__attribute__((unused))，检查是否仍有未清理的“临时保留”——这类标记不该长期存在
最容易被忽略的一点：volatile 变量即使加了 __attribute__((unused))，Clang 仍可能警告“variable is used uninitialized”，因为 volatile 的读写语义不可省略。此时必须显式初始化或至少执行一次 volatile 读，比如 volatile int* reg = &HW_REG; (void)*reg;，否则警告不会消失。
