STM32 CubeMX代码CMake脚本链接异常问题求助

尝试用CMake将CubeMX生成的文件打包为静态库，链接到可执行程序后，程序无编译/烧录错误，但运行异常。若直接将所有CubeMX源文件加入add_executable()编译，程序运行正常。

1. 垃圾代码收集导致必要符号丢失 #

-gc-sections选项会删除未被显式引用的代码段，但STM32中部分关键代码（如中断向量表、HAL弱定义回调函数）没有被主程序显式调用，会被误删。

• 解决方法：链接静态库时使用--whole-archive参数，强制包含静态库所有内容，之后用--no-whole-archive恢复默认行为：

  target_link_libraries(${PROJECT_NAME} PUBLIC
      -Wl,--whole-archive CUBEMX -Wl,--no-whole-archive
  )
  

2. 静态库与可执行文件的编译配置不一致 #

全局的add_compile_options、add_definitions可能没有完全作用于静态库，导致两者编译环境差异（比如宏定义、CPU架构选项），引发运行异常。

• 解决方法：改用目标专属的配置命令，确保静态库和可执行文件使用完全一致的编译参数：

  # 替换全局的add_definitions和add_compile_options
  target_compile_definitions(CUBEMX PUBLIC
      DEBUG
      USE_HAL_DRIVER
      STM32F439xx
  )
  
  target_compile_options(CUBEMX PUBLIC
      -mcpu=cortex-m4 -mthumb -mthumb-interwork
      -ffunction-sections -fdata-sections -fno-common -fmessage-length=0
      $<$<COMPILE_LANGUAGE:ASM>:-x$<SEMICOLON>assembler-with-cpp>
  )
  

3. 启动文件未被正确链接 #

CubeMX生成的启动汇编文件（如startup_stm32f439zitx.s）包含中断向量表，若静态库链接时该文件被忽略，程序会因缺失向量表跑飞。

• 解决方法：
  • 检查file(GLOB_RECURSE SOURCES)是否包含启动文件；
  • 若不确定，可单独将启动文件加入静态库：

    # 单独指定启动文件
    set(STARTUP_FILE ${CMAKE_SOURCE_DIR}/Core/Startup/startup_stm32f439zitx.s)
    add_library(CUBEMX STATIC ${SOURCES} ${STARTUP_FILE})
    

4. 链接顺序与符号解析问题 #

静态库的链接顺序会影响符号解析，若依赖库的顺序错误，可能导致符号无法找到。

• 解决方法：将依赖库放在使用它的代码之后，或用--start-group/--end-group包裹库，让链接器循环解析：

  target_link_libraries(${PROJECT_NAME} PUBLIC
      -Wl,--start-group CUBEMX -Wl,--end-group
  )
  

set(CMAKE_SYSTEM_NAME Generic)
set(CMAKE_SYSTEM_VERSION 1)
cmake_minimum_required(VERSION 3.25)

# 指定交叉编译工具链
set(CMAKE_C_COMPILER arm-none-eabi-gcc)
set(CMAKE_CXX_COMPILER arm-none-eabi-g++)
set(CMAKE_ASM_COMPILER  arm-none-eabi-gcc)
set(CMAKE_AR arm-none-eabi-ar)
set(CMAKE_OBJCOPY arm-none-eabi-objcopy)
set(CMAKE_OBJDUMP arm-none-eabi-objdump)
set(SIZE arm-none-eabi-size)
set(CMAKE_TRY_COMPILE_TARGET_TYPE STATIC_LIBRARY)

# 项目设置
project(F439CMake C CXX ASM)
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_C_STANDARD 11)

# 浮点运算配置（按需取消注释）
# target_compile_definitions(CUBEMX PUBLIC ARM_MATH_CM4;ARM_MATH_MATRIX_CHECK;ARM_MATH_ROUNDING)
# target_compile_options(CUBEMX PUBLIC -mfloat-abi=hard -mfpu=fpv4-sp-d16)
# target_link_options(CUBEMX PUBLIC -mfloat-abi=hard -mfpu=fpv4-sp-d16)

# target_compile_options(CUBEMX PUBLIC -mfloat-abi=soft)

# 收集源文件
file(GLOB_RECURSE SOURCES "Core/*.*" "Drivers/*.*")
set(STARTUP_FILE ${CMAKE_SOURCE_DIR}/Core/Startup/startup_stm32f439zitx.s)

# 链接脚本
set(LINKER_SCRIPT ${CMAKE_SOURCE_DIR}/STM32F439ZITX_FLASH.ld)

# 创建静态库
add_library(CUBEMX STATIC ${SOURCES} ${STARTUP_FILE})

# 配置静态库的编译参数
target_include_directories(CUBEMX PUBLIC
    Core/Inc
    Drivers/STM32F4xx_HAL_Driver/Inc
    Drivers/STM32F4xx_HAL_Driver/Inc/Legacy
    Drivers/CMSIS/Device/ST/STM32F4xx/Include
    Drivers/CMSIS/Include
)

target_compile_definitions(CUBEMX PUBLIC
    DEBUG
    USE_HAL_DRIVER
    STM32F439xx
)

target_compile_options(CUBEMX PUBLIC
    -mcpu=cortex-m4 -mthumb -mthumb-interwork
    -ffunction-sections -fdata-sections -fno-common -fmessage-length=0
    $<$<COMPILE_LANGUAGE:ASM>:-x$<SEMICOLON>assembler-with-cpp>
)

# 根据编译类型设置优化选项
if ("${CMAKE_BUILD_TYPE}" STREQUAL "Release")
    message(STATUS "Maximum optimization for speed")
    target_compile_options(CUBEMX PUBLIC -Ofast)
elseif ("${CMAKE_BUILD_TYPE}" STREQUAL "RelWithDebInfo")
    message(STATUS "Maximum optimization for speed, debug info included")
    target_compile_options(CUBEMX PUBLIC -Ofast -g)
elseif ("${CMAKE_BUILD_TYPE}" STREQUAL "MinSizeRel")
    message(STATUS "Maximum optimization for size")
    target_compile_options(CUBEMX PUBLIC -Os)
else ()
    message(STATUS "Minimal optimization, debug info included")
    target_compile_options(CUBEMX PUBLIC -Og -g)
endif ()

# 创建可执行文件
add_executable(${PROJECT_NAME} Core/Src/main.c ${LINKER_SCRIPT})

# 链接配置
target_link_options(${PROJECT_NAME} PUBLIC
    -Wl,-gc-sections,--print-memory-usage,-Map=${PROJECT_BINARY_DIR}/${PROJECT_NAME}.map
    -mcpu=cortex-m4 -mthumb -mthumb-interwork
    -T ${LINKER_SCRIPT}
)

# 链接静态库，使用--whole-archive确保所有符号被包含
target_link_libraries(${PROJECT_NAME} PUBLIC
    -Wl,--whole-archive CUBEMX -Wl,--no-whole-archive
)

# 生成hex和bin文件
set(HEX_FILE ${PROJECT_BINARY_DIR}/${PROJECT_NAME}.hex)
set(BIN_FILE ${PROJECT_BINARY_DIR}/${PROJECT_NAME}.bin)

set_target_properties(${PROJECT_NAME} PROPERTIES SUFFIX ".elf")

add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
        COMMAND ${CMAKE_OBJCOPY} -Oihex $<TARGET_FILE:${PROJECT_NAME}> ${HEX_FILE}
        COMMAND ${CMAKE_OBJCOPY} -Obinary $<TARGET_FILE:${PROJECT_NAME}> ${BIN_FILE}
        COMMENT "Building ${HEX_FILE}\nBuilding ${BIN_FILE}")

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