无导出属性时CMake构建可执行文件链接共享库失败的解决方法

核心原因 #

Windows平台下，共享库（DLL）的符号默认不会对外暴露，而静态库会将所有符号打包进目标文件。你遇到的Hello类构造函数和Say函数未定义错误，本质是这些符号没有被导出到DLL中，导致链接器无法找到。

解决步骤 #

1. 给共享库添加符号导出宏 #

在Lib模块的hello.h中定义导出宏，区分编译共享库和使用共享库的场景：

// hello.h
#ifndef HELLO_H
#define HELLO_H

// 定义导出宏，编译共享库时导出符号，使用时导入符号
#ifdef LIB_EXPORTS
#define LIB_API __declspec(dllexport)
#else
#define LIB_API __declspec(dllimport)
#endif

class LIB_API Hello {
public:
    Hello();
    void Say();
};

#endif // HELLO_H

2. 配置Lib模块的CMakeLists.txt #

在Lib的CMake配置中添加编译定义，确保编译共享库时触发符号导出：

# Lib/CMakeLists.txt
add_library(Lib SHARED
    hello.h
    hello.cc
)

# 编译共享库时，定义LIB_EXPORTS宏，让hello.h中的dllexport生效
target_compile_definitions(Lib PRIVATE LIB_EXPORTS)

# 公开头文件目录，让Main模块能直接引用hello.h
target_include_directories(Lib PUBLIC ${CMAKE_CURRENT_SOURCE_DIR})

3. 配置Main模块的CMakeLists.txt #

直接通过target_link_libraries链接Lib，CMake会自动处理依赖路径和链接信息：

# Main/CMakeLists.txt
add_executable(Main main.cc)

# 链接共享库Lib
target_link_libraries(Main PRIVATE Lib)

4. 根目录CMakeLists.txt #

确保两个模块被正确包含：

# 根目录CMakeLists.txt
cmake_minimum_required(VERSION 3.24)
project(MyProject)

add_subdirectory(Lib)
add_subdirectory(Main)

验证操作 #

1. 清理旧构建目录避免缓存干扰：

rm -rf build
mkdir build && cd build
cmake -G Ninja -DCMAKE_C_COMPILER=clang -DCMAKE_CXX_COMPILER=clang++ ..
ninja

2. 运行生成的Main.exe，确认功能正常。

常见误区 #

• 无需手动使用target_link_directories，CMake通过target_link_libraries会自动传递依赖的路径和链接规则。
• 不要忽略Windows DLL的符号导出规则：这是Windows与Linux/macOS的核心差异——Linux默认导出所有符号，而Windows必须显式声明。

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