芯片：ESP32-S3N16R8
IDF 版本：v6.0.1
CMake 版本：4.0.3
编译器：xtensa-esp32s3-elf-gcc 15.2.0
时间：2026-06-14
现象
idf.py build 在 CMake 配置阶段报错：
CMake Error at C:/esp/v6.0.1/esp-idf/tools/cmake/component.cmake:703 (target_compile_options):target_compile_options may only set INTERFACE properties on INTERFACE targets
Call Stack (most recent call first):components/BSP/CMakeLists.txt:12 (component_compile_options)
出错的 CMakeLists.txt
set(src_dirs Scr)set(include_dirs Inc)set(requires driver)idf_component_register(SRCS_DIRS ${src_dirs} # ← 问题在这里INCLUDE_DIRS ${include_dirs}REQUIRES ${requires})component_compile_options(-ffast-math -O3 -Wno-error=format -Wno-format)
根因
SRCS_DIRS 内部通过 file(GLOB) 搜索 *.c 文件：
# ESP-IDF component.cmake 内部实现 (__component_add_sources 宏)
file(GLOB dir_sources "${abs_dir}/*.c" "${abs_dir}/*.cpp" "${abs_dir}/*.S")if(dir_sources)foreach(src ${dir_sources})list(APPEND sources "${src}")endforeach()
else()message(WARNING "No source files found for SRC_DIRS entry '${dir}'.")
endif()
CMake 4.0.3 + Windows 环境下，宏作用域内的 file(GLOB) 未能将结果正确回传到 idf_component_register 函数的 sources 变量中。
由于 sources 为空，idf_component_register 将组件创建为 INTERFACE library（header-only）：
# idf_component_register 内部
if(sources OR __EMBED_FILES OR __EMBED_TXTFILES)add_library(${component_lib} STATIC ${sources})
else()add_library(${component_lib} INTERFACE) # ← 走到这里
endif()
随后 component_compile_options 尝试对 INTERFACE target 设置 PRIVATE 编译选项，CMake 直接报错：
function(component_compile_options)target_compile_options(${COMPONENT_LIB} PRIVATE ${ARGV})# INTERFACE target 不接受 PRIVATE → 报错
endfunction()
修复
用显式 SRCS 替代 SRCS_DIRS，绕过 file(GLOB)：
set(srcs "Scr/led.c")set(include_dirs Inc)set(requires esp_driver_gpio)idf_component_register(SRCS ${srcs} # ← 显式指定源文件INCLUDE_DIRS ${include_dirs}REQUIRES ${requires})component_compile_options(-ffast-math -O3 -Wno-error=format -Wno-format)
总结
| 写法 | 结果 |
|---|---|
SRCS_DIRS Scr |
CMake 4.0.3 下 file(GLOB) 不回传结果，组件变 INTERFACE，component_compile_options 报错 |
SRCS "Scr/led.c" |
正常工作，组件注册为 STATIC library |
SRCS_DIRS 本身没有问题，是 CMake 4.0.3 宏作用域 + file(GLOB) + ESP-IDF 的特定调用链组合导致的兼容性缺陷。当组件源文件较少时，直接用 SRCS 显式列举反而更清晰可靠。