ESP-IDF框架编译ESP32程序出现Serial_Init undefined reference链接错误

这个undefined reference to 'Serial_Init'报错和头文件配置无关——你当前能正常使用头文件里定义的宏，就说明头文件的包含路径配置完全正确。
这里要理清一个容易混淆的逻辑：头文件中的宏定义是在预编译阶段处理的，只要头文件在包含路径内就能正常展开使用，这个过程不依赖对应.c文件的编译，所以宏能正常使用不代表.c文件已经被纳入编译流程。
本质原因是**serial_cli.c源文件没有被ESP-IDF的构建系统纳入编译范围，最终生成的目标库里完全没有Serial_Init的函数实现，导致链接器找不到对应符号**。从你的编译输出可以佐证：整个编译流程只生成了blink.c.obj，完全没有对serial_cli.c的编译动作。

• 第一步：核对源文件实际位置
  确认serial_cli.c和主程序blink.c处于同一目录：也就是blink\main\文件夹下，避免误存到其他子目录导致构建系统扫描不到。
• 第二步：更新组件CMake配置（绝大多数场景的触发原因）
  ESP-IDF构建系统会读取每个组件目录下的CMakeLists.txt，明确指定需要编译哪些源文件。你在原有blink示例基础上新增serial_cli.c后，默认的CMake配置只会编译原有的blink.c，不会自动扫描目录下新增的源文件。
  打开main/CMakeLists.txt文件，找到idf_component_register配置段，将serial_cli.c加入SRCS（源文件列表）参数：
  原配置：

  idf_component_register(SRCS "blink.c"
                      INCLUDE_DIRS ".")
  

  修改为：

  idf_component_register(SRCS "blink.c" "serial_cli.c"
                      INCLUDE_DIRS ".")
  

  注意每个源文件名称需要用双引号包裹，不同文件之间用空格分隔。
• 第三步：清除旧缓存重新编译
  CMake会缓存之前的源文件列表配置，直接编译可能不会识别新的修改。先执行全量清理命令：
  idf.py fullclean
  清理完成后再重新执行idf.py build，这次编译输出里会出现单独编译serial_cli.c.obj的步骤，链接器就能正常找到Serial_Init的实现，报错自然消失。

补充排查项 #

如果完成以上步骤后仍报同样的错误，可以检查下serial_cli.c是不是被误改成了.cpp后缀。这种情况下如果没有在头文件中给函数加extern "C"声明，会因为C/C++名字修饰规则不兼容导致链接失败，但从你当前的编译输出来看，不属于这类问题。

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