CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS混合显式__declspec时导出异常问题

问题本质 #

在Windows MinGW环境中，启用CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS试图自动导出所有符号时，若库中存在显式标记__declspec(dllexport)的函数（比如示例中的bar()），未加该修饰的函数（比如foo()）会无法被导出，最终触发链接器"undefined reference"报错。

核心原因是MinGW工具链的特殊行为：一旦有函数被显式声明为dllexport，链接器会自动切换到"显式导出"模式，不再默认导出所有符号。而CMake的CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS是基于MSVC逻辑设计的，无法覆盖MinGW的这一行为。

解决方案 #

方案1：给目标添加MinGW专属链接器选项（推荐，无需修改源码） #

在CMakeLists.txt中，针对foobar库添加强制导出所有符号的链接器参数：

cmake_minimum_required(VERSION 3.20 FATAL_ERROR)

project(Test VERSION 1.0.0)

option(BUILD_SHARED_LIBS "Build the project using shared libraries (Windows *.dll, or Linux *.so)" ON)

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -O3")
set(CMAKE_CXX_STANDARD 17)

add_library(foobar foobar.cpp)
target_compile_definitions(foobar PRIVATE "FOOBAR_LIBRARY")

# 添加MinGW专属链接选项
if(MINGW)
  target_link_options(foobar PRIVATE -Wl,--export-all-symbols)
endif()

add_library(baz baz.cpp)
target_link_libraries(baz PUBLIC foobar)

该选项直接告知MinGW链接器导出所有符号，不受显式dllexport声明的影响，完全适配自动生成代码的场景。

方案2：调整导出宏+编译选项（兼容显式声明） #

若需保留显式导出宏的语义，可修改FOOBAR_EXPORT定义，并配合编译选项：

/****** foobar.h ******/
#pragma once

#if defined(FOOBAR_LIBRARY) && defined(_WIN32)
#define FOOBAR_EXPORT __declspec(dllexport)
#else
#define FOOBAR_EXPORT __declspec(dllimport)
#endif

同时在CMake中给foobar目标添加编译选项，确保默认符号可见：

if(MINGW)
  target_compile_options(foobar PRIVATE -fvisibility=default)
  target_link_options(foobar PRIVATE -Wl,--export-all-symbols)
endif()

-fvisibility=default让编译器默认将所有符号标记为可见，再配合链接器的导出选项，确保所有符号都能被正确导出。

方案3：替换CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS为MinGW原生配置 #

直接放弃使用CMake的跨平台变量，改用MinGW专属的编译和链接选项：

cmake_minimum_required(VERSION 3.20 FATAL_ERROR)

project(Test VERSION 1.0.0)

option(BUILD_SHARED_LIBS "Build the project using shared libraries (Windows *.dll, or Linux *.so)" ON)

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g -O3")
set(CMAKE_CXX_STANDARD 17)

# 针对MinGW设置原生导出选项
if(MINGW)
  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fvisibility=default")
  set(CMAKE_SHARED_LINKER_FLAGS "${CMAKE_SHARED_LINKER_FLAGS} -Wl,--export-all-symbols")
else()
  # 其他平台继续使用CMake的变量
  set(CMAKE_WINDOWS_EXPORT_ALL_SYMBOLS ON)
endif()

add_library(foobar foobar.cpp)
target_compile_definitions(foobar PRIVATE "FOOBAR_LIBRARY")
add_library(baz baz.cpp)
target_link_libraries(baz PUBLIC foobar)

这种方式兼顾了其他平台的兼容性，同时在MinGW下保证所有符号被导出。

总结 #

对于大型自动生成的代码（比如OpenAPI生成的代码），方案1或方案3是最优选择，无需修改生成的源码，仅通过调整CMake配置即可解决问题，维护成本极低。

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