CMake链接异常：调用静态库函数返回值不符问题求助

问题 #

在STM32CubeIDE中为STM32H755构建.elf项目时，通过FetchContent引入Git仓库的静态库ringbuff，编译过程无错误，但调用库中GetVersion()函数返回值为0而非预期的3；在非IDE环境生成.exe时该函数可正常返回3。已关闭编译器优化，支持单步调试，仅存在变量a未使用的提示，怀疑是链接环节出现问题，请问遗漏了什么？如何进一步调试？

相关代码 #

Main.c

#include <stdint.h>
#include "ringbuff.h"

int main(void)
{
    static int a = 1;
    a = GetVersion(); // 调用后a的值为0
    for(;;);
}

ringbuff.c（来自静态库）

#include "ringbuff.h"

int GetVersion()
{
    return 3;
}

注：该库的头文件ringbuff.h中声明的是int GetVersion2();

主项目CMakeLists.txt（仅保留引入库的核心部分）

cmake_minimum_required(VERSION 3.20)

set (PROJECT_NAME             "CM7")

# 源文件列表
set (PROJECT_SOURCES
    Startup/startup_stm32h755zitx.s
    Sources/system_stm32h7xx_dualcore_boot_cm4_cm7.c
    Sources/main.c
    Sources/syscalls.c
    Sources/sysmem.c
    )

# 编译宏定义
set (PROJECT_DEFINES
        CORE_CM7
        STM32H755xx
    ) 

# 头文件目录
set (PROJECT_INCLUDES
    Sources
      
    #STM32 HAL & CMSIS
    Drivers/STM32H7xx_HAL_Driver/Inc
    Drivers/STM32H7xx_HAL_Driver/Inc/Legacy
    Drivers/CMSIS/Device/ST/STM32H7xx/Include
    Drivers/CMSIS/Include
    )

project(${PROJECT_NAME})
enable_language(ASM)

add_executable(${PROJECT_NAME} ${PROJECT_SOURCES})
add_custom_command(TARGET ${CMAKE_PROJECT_NAME} POST_BUILD COMMAND ${CMAKE_SIZE} $<TARGET_FILE:${CMAKE_PROJECT_NAME}>)

################# 引入模块 #####################
include(FetchContent)
Set(FETCHCONTENT_QUIET FALSE)
FetchContent_Declare(
  ringbuff
  GIT_REPOSITORY https://github.com/TESTMODULE.git
  GIT_TAG        V0.7
  GIT_PROGRESS   TRUE
)
FetchContent_MakeAvailable(ringbuff)

target_include_directories(${PROJECT_NAME}
    PUBLIC ${ringbuff_SOURCE_DIR}
)

target_link_libraries(${PROJECT_NAME} 
    PRIVATE ringbuff
)
#####################################################

target_compile_definitions(${PROJECT_NAME}
    PRIVATE ${PROJECT_DEFINES}
)
target_include_directories(${PROJECT_NAME}
    PUBLIC ${PROJECT_INCLUDES}
)

set (CMAKE_EXECUTABLE_SUFFIX ".elf")
set (CMAKE_STATIC_LIBRARY_SUFFIX ".a")
set (CMAKE_C_FLAGS "-mcpu=Cortex-M7 -O0 -std=gnu11 -mfpu=fpv5-d16 --specs=nano.specs -mthumb -Wall")
set (CMAKE_EXE_LINKER_FLAGS "-T../STM32H755ZITX_FLASH.ld --specs=nosys.specs -Wl,-Map=test.map -Wl,--gc-sections -static -Wl,--start-group -lc -lm -Wl,--end-group")
set (CMAKE_ASM_FLAGS "${CMAKE_C_FLAGS} -x assembler-with-cpp")

静态库ringbuff的CMakeLists.txt

# Minimum version of CMake required
cmake_minimum_required(VERSION 3.20)

# Project name
project(RingBuffer C)

# Add the source files
add_library(ringbuff STATIC ringbuff.c)

排查与解决步骤 #

1. 修复函数声明与定义的不匹配 #

从代码看，ringbuff.h中声明的是GetVersion2()，但库实现的是GetVersion()——这是核心问题：

• C语言中，未匹配的函数会触发隐式声明，链接时会绑定到一个空实现（默认返回0是常见行为）。
• 立即修正：将ringbuff.h中的函数声明改为int GetVersion();，确保声明与实现完全一致。

2. 验证静态库的符号存在性 #

用ARM工具链的nm命令检查静态库是否包含目标函数符号：

arm-none-eabi-nm ringbuff.a | grep GetVersion

• 若输出包含T GetVersion，说明函数已编译入库；若无输出，说明库的编译过程异常，需检查库的构建日志。

3. 统一主项目与静态库的编译参数 #

静态库的编译参数必须与主项目匹配（尤其是架构相关参数），否则会导致指令集不兼容：

• 修改静态库的CMakeLists.txt，添加与主项目一致的编译选项：

cmake_minimum_required(VERSION 3.20)
project(RingBuffer C)

# 同步主项目的编译参数
set(CMAKE_C_FLAGS "-mcpu=Cortex-M7 -O0 -std=gnu11 -mfpu=fpv5-d16 --specs=nano.specs -mthumb -Wall")
add_library(ringbuff STATIC ringbuff.c)

4. 临时关闭链接时的垃圾回收选项 #

主项目链接参数中的-Wl,--gc-sections会删除未被引用的代码段，虽然理论上被调用的函数不会被回收，但可临时注释该选项测试：

# 注释掉该行，重新构建测试
# set (CMAKE_EXE_LINKER_FLAGS "-T../STM32H755ZITX_FLASH.ld --specs=nosys.specs -Wl,-Map=test.map -Wl,--gc-sections -static -Wl,--start-group -lc -lm -Wl,--end-group")

5. 通过调试追踪函数调用 #

• 在a = GetVersion();行设置断点，单步进入（Step Into）函数：
  • 若能进入ringbuff.c的GetVersion()实现，说明链接正常，需检查返回值的处理逻辑；
  • 若无法进入，说明链接的不是预期的函数实现，需排查符号冲突或库的链接路径。

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