C++：头文件调用外部库链接失败，cpp调用正常（CMake/VS）

当你将e57wrapper设为SHARED共享库时，头文件（.hpp）中的inline函数或模板函数会在每个包含该头文件的编译单元（比如主项目的代码）中被实例化。这些实例化后的代码直接依赖E57Format的符号（比如e57::RigidBodyTransform的构造/析构函数），但主项目的编译单元并没有链接E57Format库，因此链接器抛出LNK2019未解析外部符号错误。

而设为STATIC静态库时，链接器会在最终链接阶段将静态库的代码与主项目代码合并，同时静态库已经链接了E57Format的符号，所有依赖的符号会被一并纳入可执行文件，因此不会报错。

根据你的需求（保留SHARED库+模板/inline函数必须在头文件），提供以下几种可行方案：

方案1：让主项目显式链接E57Format库 #

在主项目的CMake配置中，确保主目标链接E57Format库（如果E57Format是通过CMake导入的目标，直接添加即可）：

# 主项目CMakeLists.txt
add_executable(main_project main.cpp)
# 引入e57wrapper子目录
add_subdirectory(e57wrapper)
# 让主项目同时链接e57wrapper和E57Format
target_link_libraries(main_project PRIVATE e57wrapper E57Format)

这样主项目的编译单元在实例化头文件中的函数时，能找到E57Format的符号。

方案2：在e57wrapper的.cpp中显式实例化模板/inline函数 #

如果你的模板函数只针对特定类型实例化，可以在e57wrapper的.cpp文件中显式实例化这些模板，将符号纳入共享库中，主项目就不需要链接E57Format：

// e57wrapper.cpp
#include "e57wrapper.hpp"

// 假设你的模板函数是template<typename T> void foo(T val)
// 显式实例化你需要的类型，比如int、double等
template void foo<int>(int val);
template void foo<double>(double val);

// 对于inline函数，如果需要确保符号在共享库中存在，可以强制实例化（部分编译器支持）
inline void bar() {
    e57::RigidBodyTransform transform;
    // ...
}
// 强制生成bar的符号
void force_instantiate_bar() { bar(); }

同时在CMake中确保e57wrapper正确链接E57Format：

# e57wrapper/CMakeLists.txt
add_library(e57wrapper SHARED e57wrapper.cpp e57wrapper.hpp)
target_link_libraries(e57wrapper PRIVATE E57Format)

方案3：将E57Format静态链接到e57wrapper共享库 #

如果E57Format提供静态库版本，可以修改e57wrapper的CMake配置，将E57Format静态链接到共享库中，这样e57wrapper会包含E57Format的符号，主项目只需链接e57wrapper即可：

# e57wrapper/CMakeLists.txt
# 确保找到E57Format的静态库
find_package(E57Format REQUIRED CONFIG)
add_library(e57wrapper SHARED e57wrapper.cpp e57wrapper.hpp)
# 链接静态版本的E57Format（如果目标名是E57Format::E57Format-static）
target_link_libraries(e57wrapper PRIVATE E57Format::E57Format-static)
# 对于MSVC，需要设置链接选项确保静态库被嵌入共享库
if(MSVC)
    target_link_options(e57wrapper PRIVATE /WHOLEARCHIVE:$<TARGET_FILE:E57Format::E57Format-static>)
endif()

• 不要试图将.hpp文件添加到add_library中，CMake不会编译头文件，添加进去只是起到文件跟踪作用，对链接问题毫无帮助。
• 对于MSVC平台，共享库的符号导出需要注意：如果你的e57wrapper有自己的导出宏（比如E57WRAPPER_EXPORT），确保inline/模板函数的实例化符号被正确导出，但这通常不是LNK2019的核心原因，核心还是依赖库的符号可见性问题。

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