调整CMake中target_link_libraries的链接库顺序为何报错？

这个问题本质是链接器的符号解析规则导致的，和CMake本身关系不大——CMake只是把你指定的库顺序原封不动传给了底层的链接器（比如GCC用的ld、Clang用的lld）。

链接器的核心工作逻辑 #

像GCC、Clang配套的链接器，都是按从左到右的顺序处理库文件，遵循以下规则：

• 处理某个库时，只解决当前已经出现的未定义符号，不会主动记录该库的所有符号留待后续使用
• 如果当前没有未定义符号需要该库解决，链接器会直接跳过这个库的符号，不会将它们加入最终的可执行文件

你的场景具体分析 #

你的情况里：

• VAR定义在config库中，http、core、utils三个库都引用了VAR
• 当config放在最前面时：
  链接器先处理config，此时还没处理http/core/utils，没有未定义的VAR引用，所以config里的VAR符号直接被忽略。后续处理http/core/utils时，这些库用到VAR但找不到定义，就会报undefined reference to VAR。
• 当config移到最后时：
  链接器先处理http/core/utils，这三个库产生了VAR的未定义引用。最后处理config时，链接器发现这个库有VAR的定义，正好解决前面的未引用问题，因此编译正常通过。

更省心的写法（可选） #

如果不想手动纠结库的顺序，可以用CMake的PUBLIC/PRIVATE/INTERFACE来管理依赖关系，让CMake自动处理顺序：
比如给每个依赖config的库设置：

target_link_libraries(http PRIVATE config)
target_link_libraries(core PRIVATE config)
target_link_libraries(utils PRIVATE config)

之后链接最终目标时，只需要写：

target_link_libraries(HTTPCPP http core utils)

CMake会自动把config放到合适的位置，不用你手动调整顺序。

内容的提问来源于stack exchange，提问作者Fikra Laksana Putra