Windows环境下编译cmocka单元测试出现未定义引用错误问题咨询

首次编译的错误原因 #

你有两处核心操作错误：

• -L（指定库搜索路径）和-l（指定要链接的库）是链接阶段专属参数，不能加在带-c的编译生成目标文件的阶段，这个阶段GCC会直接忽略这两个参数，你等于没有告知链接器需要关联cmocka库。
• 第二行执行链接操作的命令里，完全没有加库路径和链接cmocka的参数，链接器只会从你给出的.o文件里找符号，自然找不到cmocka相关的函数定义。

如果要走库链接的方式，正确的命令应该是：

# 仅编译阶段，不需要加库相关参数
gcc -c .\Test.c .\src\some_module.c
# 链接阶段添加库路径和链接参数
gcc .\Test.o .\some_module.o -L./bin/ -lcmocka -o main

如果执行修正后的命令仍然报错，需要确认./bin目录下存在libcmocka.a（静态库）或者libcmocka.dll.a（动态库导入库），如果使用动态库还需要把对应的cmocka.dll放到和生成的main.exe同目录或者系统PATH路径下。

两种编译方式的区别 #

• 第一种库链接方式：依赖提前编译好的cmocka二进制库文件，不会重复编译cmocka源码。如果链接的是静态库，cmocka的代码会直接打包进最终的可执行文件；如果链接的是动态库，运行程序时还需要额外依赖对应的dll文件。
• 第二种源码直接编译方式：将cmocka源码和你的业务、测试代码放在一起统一编译，每次构建你的测试程序时，cmocka都会被重新编译一次，所有代码最终会合并链接成可执行文件。

最优实践选择 #

根据场景选择即可：

• 如果你是做小型临时测试，或者需要修改cmocka源码适配项目需求，直接编译源码的方式更简单，不需要处理库编译、路径配置、符号导出等繁琐问题，出错概率极低。
• 如果是团队大型项目，存在多个测试用例都依赖cmocka的情况，推荐提前编译成静态库使用：仅需要编译一次cmocka源码，后续所有测试用例构建时直接链接静态库即可，既可以节省编译时间，也能统一整个项目的cmocka版本，避免不同模块用不同版本cmocka源码带来的兼容性问题。
• Windows场景下不推荐使用cmocka动态库做单元测试：需要额外处理dll路径、符号导出等问题，对单元测试场景没有明显收益，反而容易引发环境相关的异常。

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