undefined reference to `app_main' collect2.exe: error: ld returned 1 exit status ninja: build stopped: subcommand failed. 二十篇

### 链接器错误分析 链接器错误 `undefined reference to app_main` 表明在链接阶段，编译器无法找到函数 `app_main` 的定义。这种问题通常由以下几个原因引起： 1. **未实现 `app_main` 函数** 如果项目中缺少 `app_main` 函数的实际定义，则会触发此错误[^1]。 2. **文件未被正确包含到构建过程中** 即使实现了 `app_main` 函数，但如果该文件未被 CMake 或其他构建工具正确识别并加入到编译流程中，也会导致同样的错误[^2]。 3. **链接顺序问题** 在某些情况下，静态库或对象文件的链接顺序不当也可能引发此类错误。如果某个依赖项需要先于调用它的模块被链接，则可能需要调整链接顺序。 4. **语法或配置错误** 如引用中的信息所示，可能存在 `.ld` 文件中的语法错误或其他配置问题，这会影响整个项目的正常构建过程。 --- ### 解决方案 #### 方法一：确认 `app_main` 是否已实现 检查源码目录下是否有如下形式的函数定义： ```c++ void app_main() { // 主逻辑代码 } ``` 如果没有，请根据实际需求补充其实现部分。 #### 方法二：验证 CMakeLists.txt 设置 确保包含 `app_main` 实现的源文件已被正确定义至目标列表中。例如，在 `CMakeLists.txt` 中应有类似以下内容： ```cmake add_executable(my_target main.cpp other_file.cpp) target_link_libraries(my_target PRIVATE some_library) ``` 这里需特别注意是否遗漏了任何必要的源文件路径声明。 #### 方法三：排查链接顺序冲突 对于复杂的多模块项目来说，有时会出现因链接次序不匹配而导致符号解析失败的情况。可以尝试通过重新安排 `-l<library>` 参数的位置来解决问题；或者利用 GNU Linker 提供的相关选项（比如 `--start-group ... --end-group`），让所有指定库都能相互作用从而完成最终绑定操作。 #### 方法四：修正启动脚本与链接描述符文件 从另一个角度出发，查看是否存在关于入口点名称设置方面的差异。一些嵌入式平台可能会期望特定的名字作为程序起点而非标准意义上的 `main()` 。因此有必要查阅文档了解具体要求，并相应修改 Makefile/CMake 脚本以及 linker script (.ld file)[^2]。 --- ### 示例修复代码片段 以下是针对 STM32 平台的一个简单例子展示如何添加自定义 entry point 和处理相关 cmake configuration: ```cpp // Custom Entry Point Definition (e.g., app_main()) extern "C" void app_main(void){ printf("Application started successfully.\n"); } int main(){ app_main(); while(1); } ``` 对应调整后的 CMakeLists.txt 可能看起来像这样: ```cmake set(CMAKE_EXE_LINKER_FLAGS "${CMAKE_EXE_LINKER_FLAGS} -Wl,--entry=Reset_Handler") include_directories(${PROJECT_SOURCE_DIR}/src) aux_source_directory(. SRC_LIST) add_executable(example ${SRC_LIST}) # Specify additional libraries or flags here if needed. target_link_libraries(example ...) ``` ---