如何在ESP-IDF项目中添加外部库并解决函数未定义引用报错

能识别fftw_complex类型但调用函数报undefined reference to fftw_malloc，说明编译阶段已经正确找到FFTW的头文件，但链接阶段没有把FFTW的实现代码链接进最终固件，本质是CMake配置没有正确声明依赖、没有把FFTW的源文件或预编译库加入构建流程。

根据你存放FFTW的方式二选一配置即可：

场景1：直接使用FFTW源码集成 #

这是ESP-IDF下最稳妥的集成方式，不会有架构兼容问题：

1. 在项目根目录新建components/fftw文件夹，把FFTW所有的.c源文件、.h头文件全部复制到这个文件夹下
2. 在components/fftw目录下新建CMakeLists.txt，写入以下内容：

idf_component_register(
    SRCS "把所有FFTW的.c文件名填在这里，多个文件用空格分隔，例如fftw.c fftw_malloc.c"
    INCLUDE_DIRS "."
)

3. 修改main目录下的CMakeLists.txt，添加对fftw组件的依赖：

idf_component_register(SRCS "hello_world_main.c"
                    INCLUDE_DIRS "."
                    REQUIRES fftw)

场景2：使用预编译好的FFTW静态库 #

必须使用ESP-IDF对应版本的xtensa-esp32-elf交叉工具链编译出的.a静态库，PC端x86架构编译的库完全无法在ESP32上使用：

1. 在main目录下新建fftw_lib文件夹，内部再分include（放FFTW所有头文件）和lib（放编译好的libfftw.a文件）两个子目录
2. 修改main目录下的CMakeLists.txt，添加头文件路径和链接配置：

idf_component_register(SRCS "hello_world_main.c"
                    INCLUDE_DIRS "." "fftw_lib/include")

target_link_libraries(${COMPONENT_LIB} INTERFACE "${CMAKE_CURRENT_SOURCE_DIR}/fftw_lib/lib/libfftw.a")

• 如果你图省事直接把FFTW源码全丢在main目录下，必须把所有FFTW的.c文件全部加到main组件idf_component_register的SRCS列表里，你当前配置只编译了hello_world_main.c，FFTW的源码根本没参与构建，必然报链接错误
• 改完CMake配置后必须执行全量清理再重新编译，在终端运行以下命令避免构建缓存干扰：

idf.py fullclean
idf.py build

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