CMake链接子模块失败：undefined reference错误求助

错误原因分析 #

错误信息里的undefined reference to void fmt_println2<char [5]>(char const (&) [5])本质是C++模板编译机制导致的问题，和CMake链接配置无关：
模板函数的定义放在了fmt_formatter.cpp中，但C++模板要求在调用它的编译单元（此处为main.cpp）中可见完整定义，才能生成对应的实例化代码。main.cpp编译时仅能看到头文件里的模板声明，无法获取.cpp中的实现，因此编译器不会生成fmt_println2<const char[5]>的实例；而fmt_formatter.cpp中也没有触发该模板的实例化，最终库文件里不存在这个符号，链接器自然找不到。

可行解决方案 #

方案1：将模板函数实现移到头文件（推荐） #

把fmt_formatter.cpp中的模板函数实现直接放到fmt_formatter.h里，确保调用模板的编译单元能获取完整定义。修改后的头文件示例：

#include "fmt/core.h"
#include "fmt/color.h"

template<typename... Args>
void fmt_println(const fmt::text_style &ts, bool color = true, const Args &... args) {
    fmt::print(color ? ts : fmt::text_style(), args...);
    fmt::print("\n");
    fflush(stdout);
}

template<typename... Args>
void fmt_println2(const Args &... args) {
    fmt::print(fmt::text_style(), args...);
    fmt::print("\n");
    fflush(stdout);
}

同时删除fmt_formatter.cpp中的对应模板实现代码（若有非模板代码可保留）。

方案2：显式实例化模板（仅适合固定类型场景） #

如果必须将模板实现放在.cpp中，可通过显式实例化指定需要支持的类型：

1. 修改fmt_formatter.h，添加extern模板声明：

#include "fmt/core.h"
#include "fmt/color.h"

template<typename... Args>
void fmt_println(const fmt::text_style &ts, bool color = true, const Args &... args);

template<typename... Args>
void fmt_println2(const Args &... args);

// 声明显式实例化
extern template void fmt_println2<const char(&)[5]>(const char(&)[5]);

2. 修改fmt_formatter.cpp，添加显式实例化：

#include "fmt_formatter.h"

template<typename... Args>
void fmt_println(const fmt::text_style &ts, bool color, const Args &... args) {
    fmt::print(color ? ts : fmt::text_style(), args...);
    fmt::print("\n");
    fflush(stdout);
}

template<typename... Args>
void fmt_println2(const Args &... args) {
    fmt::print(fmt::text_style(), args...);
    fmt::print("\n");
    fflush(stdout);
}

// 显式实例化需要的类型
template void fmt_println2<const char(&)[5]>(const char(&)[5]);

该方法的缺点是每次新增模板的使用类型，都需要手动添加对应的显式实例化，灵活性较差。

验证构建 #

原有的CMake配置本身无问题，修改代码后重新执行以下命令即可正常构建：

cmake -S . -B build
cmake --build build

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