ESP-IDF中仅对自有项目文件启用严格编译的问题

你当前的配置把-Wpedantic、-Werror等选项加到了组件库目标上，导致编译自有文件时，预处理框架头文件（如lwip的sockets.h）时，这些头文件中的GCC扩展语法（比如#include_next）会被-Wpedantic识别为警告，再被-Werror转为错误。因为PRIVATE选项会将编译选项应用到组件所有源文件的编译过程，包括预处理它们包含的头文件。

以下是两种可行的解决方案：

方案1：仅给自有源文件添加编译选项 #

直接将严格编译选项绑定到你的源文件（如main.cpp），而非整个组件库目标，这样选项只会作用于自有代码的编译，不会影响框架头文件的检查。

修改./main/CMakeLists.txt：

idf_component_register(SRCS "main.cpp"
                       INCLUDE_DIRS "."
                       PRIV_REQUIRES "lwip")

set(MY_FLAGS
    "-Wall"
    "-Wextra"
    "-Wpedantic"
    "-Werror"
    "-Werror=unused-function"
    "-Werror=unused-variable"
    "-Werror=unused-but-set-variable"
    "-Werror=deprecated-declarations"
)

# 仅对main.cpp应用编译选项
set_source_files_properties(main.cpp PROPERTIES COMPILE_OPTIONS "${MY_FLAGS}")

方案2：保留组件级选项，忽略系统头文件的警告 #

如果希望组件下所有自有源文件都应用这些选项，可以在编译选项中添加忽略系统头文件警告的参数，让编译器跳过对ESP-IDF框架头的严格检查。

修改./main/CMakeLists.txt中的MY_FLAGS：

idf_component_register(SRCS "main.cpp"
                       INCLUDE_DIRS "."
                       PRIV_REQUIRES "lwip")

set(MY_FLAGS
    "-Wall"
    "-Wextra"
    "-Wpedantic"
    "-Werror"
    "-Werror=unused-function"
    "-Werror=unused-variable"
    "-Werror=unused-but-set-variable"
    "-Werror=deprecated-declarations"
    "-Wno-pedantic-system-headers" # 跳过系统头文件的pedantic警告
)

target_compile_options(${COMPONENT_LIB} PRIVATE ${MY_FLAGS})

说明 #

-Wno-pedantic-system-headers是GCC的选项，作用是让编译器在处理标记为系统头文件的目录时，忽略-Wpedantic产生的警告。ESP-IDF会自动将自身组件的头目录标记为系统头，所以这个选项能精准跳过框架代码的检查，只对自有代码启用严格规则。

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