问题根源 #

C++模板是编译期实例化的，纯头文件（.hpp/.inl）实现的模板代码没有可编译的.cpp源文件，CMake的STATIC库目标如果仅包含头文件，不会生成任何静态库文件（.lib/.a），这就是链接时出现LNK1104错误的核心原因——根本没生成functions.lib。

方案1：使用接口库（推荐，符合模板设计逻辑） #

接口库（INTERFACE）专门用于封装头文件集合，不需要生成实体库，只需告诉CMake头文件路径和编译规则，让可执行文件能正确找到并编译模板代码。

正确的CMakeLists.txt #

# 最低CMake版本要求（推荐使用3.16及以上，接口库支持更完善）
cmake_minimum_required(VERSION 3.16 FATAL_ERROR)

# 定义项目名称与支持的编程语言
project(staticLibs LANGUAGES CXX)

# 创建接口库：仅传递编译/链接规则，不生成实体库文件
add_library(functions INTERFACE)

# 暴露头文件目录给所有链接该库的目标
# 这样可执行文件无需手动设置包含目录就能找到functions.hpp
target_include_directories(functions
    INTERFACE
        ${CMAKE_CURRENT_SOURCE_DIR}  # 当前CMakeLists.txt所在的目录
)

# 统一设置C++标准，确保模板代码在正确的标准下编译
target_compile_features(functions
    INTERFACE
        cxx_std_17  # 可根据需求改为cxx_std_11/cxx_std_20等
)

# 创建可执行文件目标
add_executable(main main.cpp)

# 将接口库的规则应用到可执行文件
# PRIVATE表示仅main需要这些规则，不会传递给依赖main的其他目标
target_link_libraries(main PRIVATE functions)

关键配置解释 #

• add_library(functions INTERFACE)：创建无实体的接口库，仅用于传递编译规则，不会生成.lib文件
• target_include_directories：自动将头文件目录添加到可执行文件的编译包含路径，避免代码中写硬编码路径
• target_compile_features：统一C++标准版本，防止因标准不一致导致模板编译错误
• target_link_libraries：此处的"链接"并非传统的库文件链接，而是将接口库的规则传递给可执行文件

方案2：显式实例化模板生成静态库（不推荐，限制灵活性） #

如果一定要生成静态库，需要在.cpp文件中显式实例化模板的特定类型，让CMake能编译该文件生成静态库。但这种方式会限制模板只能支持你预先实例化的类型，违背泛型编程的初衷。

修改步骤 #

1. 添加functions.cpp文件：

#include "functions.hpp"

// 显式实例化double类型的模板类，编译时会生成该类型的具体代码
template class Functions<double>;
// 若需要支持其他类型，需手动添加实例化，比如：
// template class Functions<int>;

2. 对应的CMakeLists.txt：

cmake_minimum_required(VERSION 3.16 FATAL_ERROR)
project(staticLibs LANGUAGES CXX)

# 生成静态库：包含显式实例化的.cpp文件和头文件
add_library(functions STATIC
    functions.cpp
    functions.hpp
    functions.inl
)

# 设置静态库的C++标准
target_compile_features(functions PRIVATE cxx_std_17)

# 暴露头文件目录给链接目标
target_include_directories(functions
    PUBLIC
        ${CMAKE_CURRENT_SOURCE_DIR}
)

# 创建可执行文件
add_executable(main main.cpp)

# 链接静态库到可执行文件
target_link_libraries(main PRIVATE functions)
# 确保可执行文件使用相同的C++标准
target_compile_features(main PRIVATE cxx_std_17)

注意事项 #

• 静态库中仅包含你显式实例化的模板类型代码，使用未预先实例化的类型会触发链接错误
• 仅在需要固定模板支持类型的场景下使用此方案

验证构建 #

使用原构建命令即可正常编译：

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

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