ESP32-S3项目添加源文件到CMakeLists.txt编译失败求助

环境与背景 #

• 系统：Win11
• 开发工具：VSCode + ESP-IDF插件
• ESP-IDF版本：v5.4.0
• 项目基础：基于blinky模板创建，闪烁逻辑已迁移至独立线程并正常运行

问题描述 #

在main目录下创建了ResourceFunctions.c文件，内容如下：

#include <stdint.h>

uint16_t AddThree(uint16_t _input)
{
    return _input + 3;
}

在主文件中声明了该函数原型，并修改main目录下的CMakeLists.txt将其加入SRCS列表：

idf_component_register(SRCS "blink_example_main.c" "ResourceFunctions.c"
       INCLUDE_DIRS  ".")

也尝试过换行格式的配置：

idf_component_register(SRCS 
    "blink_example_main.c" 
    "ResourceFunctions.c"
INCLUDE_DIRS 
    "."
)

在闪烁线程中调用counter = AddThree(counter);后，编译报错找不到ResourceFunctions.c文件。删除build文件夹重新生成、清理缓存后问题依旧，曾出现找不到ESP-IDF内部文件的异常。移除所有与ResourceFunctions.c相关的引用后，项目无需清理即可正常编译。

main目录文件列表：

03/31/2025  05:18 PM    <DIR>          .
03/31/2025  05:17 PM    <DIR>          ..
03/31/2025  12:46 PM             4,263 blink_example_main.c
03/31/2025  12:46 PM               133 CMakeLists.txt
03/13/2025  02:26 PM                48 idf_component.yml
03/13/2025  02:26 PM             1,620 Kconfig.projbuild
03/31/2025  12:27 PM                89 ResourceFunctions.c

排查思路 #

• 核对文件名大小写：Win11默认不区分大小写，但CMake部分场景会严格匹配，确认CMakeLists.txt中的文件名、代码中的函数引用与实际文件名完全一致，避免大小写拼写错误
• 验证CMake路径正确性：尝试用绝对路径替换相对路径，将ResourceFunctions.c改为${CMAKE_CURRENT_SOURCE_DIR}/ResourceFunctions.c，确认CMake能正确解析文件位置
• 清理VSCode插件缓存：重启VSCode，执行ESP-IDF插件的「Clean Build」和「Rebuild Project」命令，排除旧配置缓存的干扰
• 检查文件权限：确认ResourceFunctions.c未被设置为只读或被系统锁定，Win11部分文件夹权限限制可能导致CMake无法读取文件
• 重新配置ESP-IDF环境：之前出现过内部文件找不到的异常，运行ESP-IDF插件的「Configure ESP-IDF」命令，确保环境变量、工具链路径配置正确
• 核对函数声明与定义：确认主文件中的函数原型uint16_t AddThree(uint16_t _input);与ResourceFunctions.c中的定义完全匹配，返回值、参数类型不能有差异

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