ESP-IDF编译时未使用静态const变量GCC报错而非警告问题求助

触发原因 #

• ESP-IDF默认开启了-Werror=all编译规则，会将所有编译器警告升级为编译错误。
• 普通未使用变量不会触发报错，是因为ESP-IDF默认添加了-Wno-error=unused-variable豁免规则，但静态const变量的未使用检查属于独立的unused-const-variable警告分类，不在普通未使用变量的豁免范围内，所以会直接报错。
• 你定义的WRITE_CHARACTERISTIC是static修饰的文件级私有变量，编译器检测到该变量在整个文件内无引用，就触发了对应警告，最终被转为错误。

解决方法 #

根据你的使用场景可以选择以下任意一种方案：

• 临时保留变量（后续会用到）：给变量添加编译器忽略未使用检查的属性，修改定义为：

  static const uint16_t __attribute__((unused)) WRITE_CHARACTERISTIC = 0x0011;
  

• 关闭当前组件的该类警告：在BLE组件的CMakeLists.txt中添加编译选项：

  target_compile_options(${COMPONENT_LIB} PRIVATE -Wno-unused-const-variable)
  

• 关闭整个项目的该类警告：在项目顶层的CMakeLists.txt里project()指令之后添加：

  add_compile_options(-Wno-unused-const-variable)
  

• 变量需要跨文件使用：去掉static修饰符，将变量改为全局const变量，同时在对应头文件中添加extern const uint16_t WRITE_CHARACTERISTIC;声明，供其他文件引用。
• 变量确认无用：直接删除或注释该变量定义即可。

内容的提问来源于stack exchange，提问作者TheBestPlayer