Windows下构建相互依赖多DLL时，如何同时控制__declspec导入导出？

我有多个无循环依赖的DLL项目，在Linux/Mac平台运行正常，但Windows平台需要显式指定__declspec(dllexport)和__declspec(dllimport)。标准的单DLL宏方案（通过BUILD/USE类全局宏切换导入导出）无法满足需求：构建当前DLL时，需要将自身头文件标记为导出，同时将已构建完成的外部依赖DLL的头文件标记为导入。

现有通用宏定义（lib_dll.h） #

#ifndef DYNALIB_EXP_IMP
#   ifdef DYNALIB_BUILD_DLL
#     define DYNALIB_EXP_IMP      __declspec(dllexport)
#     define DYNALIB_IMPORT      __declspec(dllimport)
#     define DYNALIB_TPL
#   elif defined(DYNALIB_USE_DLL)
#     define DYNALIB_EXP_IMP      __declspec(dllimport)
#     define DYNALIB_IMPORT      __declspec(dllimport)
#     define DYNALIB_TPL         extern
#   else
#     define DYNALIB_EXP_IMP
#     define DYNALIB_IMPORT
#     define DYNALIB_TPL
#   endif
#endif

问题场景示例 #

构建某DLL时，源文件中同时引用外部依赖头文件（需导入）和自身头文件（需导出）：

#include <lib_dll.h>

#include <Utilities/Hashcoder.h>  // 需从外部DLL导入
#include <MindComponents/Goal.h>   // 当前DLL需导出
#include <MindComponents/State.h>  // 当前DLL需导出

Goal::Goal(const char* name) : _name(name) {
};

外部依赖头文件（如Hashcoder.h）的代码片段：

#include <lib_dll.h>

namespace hashc {
    extern DYNALIB_EXP_IMP const int      HASH_SEED;
    extern DYNALIB_EXP_IMP const int      HASH_MULTIPLIER;
    extern DYNALIB_EXP_IMP const unsigned HASH_MASK;

    DYNALIB_EXP_IMP int hashSeed();
    DYNALIB_EXP_IMP int hashMultiplier();
    DYNALIB_EXP_IMP int hashMask();

    DYNALIB_EXP_IMP int hashCode(bool key);
    DYNALIB_EXP_IMP int hashCode(char key);
    DYNALIB_EXP_IMP int hashCode(double key);
}

单DLL场景下该宏可以正常工作，但多DLL依赖时，全局宏无法区分当前库和依赖库的导入导出需求。

尝试的临时方案 #

我尝试将头文件按导入导出类型分类，修改lib_dll.h为：

#undef DYNALIB_EXP_IMP
#undef DYNALIB_TPL

#ifdef DYNALIB_BUILD_DLL
#  define DYNALIB_EXP_IMP      __declspec(dllexport)
#  define DYNALIB_TPL
#elif defined(DYNALIB_USE_DLL)
#  define DYNALIB_EXP_IMP      __declspec(dllimport)
#  define DYNALIB_TPL         extern
#else
#  define DYNALIB_EXP_IMP
#  define DYNALIB_TPL
#endif

#undef DYNALIB_BUILD_DLL
#undef DYNALIB_USE_DLL

然后在源文件中按顺序引入：

#include <lib_dll.h>
#include <header1.hpp>

#define DYNALIB_USE_DLL
#include <lib_dll.h>
#include <header_import_DLL1.h>
#include <header_import_DLL2.h>

#define DYNALIB_BUILD_DLL
#include <lib_dll.h>
#include <header_export1.h>
#include <header_export2.h>

但该方案未经过测试，希望得到更优的解决方案。

最优解决方案：为每个库定义独立的导入导出宏 #

核心思路是避免使用全局通用宏，给每个DLL库定义专属的导入导出宏，这样在构建任何一个库时，可以精准控制自身和依赖库的导入导出状态：

1. 为每个库创建专属的宏头文件 #

针对Utilities库，创建utilities_export.h：

#ifndef UTILITIES_EXPORT_H
#define UTILITIES_EXPORT_H

#ifdef UTILITIES_BUILD_DLL
#  define UTILITIES_API __declspec(dllexport)
#else
#  define UTILITIES_API __declspec(dllimport)
#endif

// 模板相关的宏（如果需要）
#ifdef UTILITIES_BUILD_DLL
#  define UTILITIES_TPL
#else
#  define UTILITIES_TPL extern
#endif

#endif // UTILITIES_EXPORT_H

针对MindComponents库，创建mindcomponents_export.h：

#ifndef MINDCOMPONENTS_EXPORT_H
#define MINDCOMPONENTS_EXPORT_H

#ifdef MINDCOMPONENTS_BUILD_DLL
#  define MINDCOMPONENTS_API __declspec(dllexport)
#else
#  define MINDCOMPONENTS_API __declspec(dllimport)
#endif

#ifdef MINDCOMPONENTS_BUILD_DLL
#  define MINDCOMPONENTS_TPL
#else
#  define MINDCOMPONENTS_TPL extern
#endif

#endif // MINDCOMPONENTS_EXPORT_H

2. 在各库的头文件中使用专属宏 #

Hashcoder.h示例：

#include "utilities_export.h"

namespace hashc {
    extern UTILITIES_API const int      HASH_SEED;
    extern UTILITIES_API const int      HASH_MULTIPLIER;
    extern UTILITIES_API const unsigned HASH_MASK;

    UTILITIES_API int hashSeed();
    UTILITIES_API int hashMultiplier();
    UTILITIES_API int hashMask();

    UTILITIES_API int hashCode(bool key);
    UTILITIES_API int hashCode(char key);
    UTILITIES_API int hashCode(double key);
}

Goal.h示例：

#include "mindcomponents_export.h"

class MINDCOMPONENTS_API Goal {
public:
    Goal(const char* name);
private:
    const char* _name;
};

3. 通过CMake为每个库设置专属编译宏 #

构建MindComponents库的CMakeLists.txt：

add_library(MindComponents SHARED
    Goal.cpp
    State.cpp
)

# 定义当前库的BUILD宏，用于导出自身符号
target_compile_definitions(MindComponents PRIVATE MINDCOMPONENTS_BUILD_DLL)

# 链接依赖的Utilities库
target_link_libraries(MindComponents PRIVATE Utilities)

# 确保依赖库的头文件可被找到
target_include_directories(MindComponents PRIVATE ${UTILITIES_INCLUDE_DIR})

构建Utilities库的CMakeLists.txt：

add_library(Utilities SHARED
    Hashcoder.cpp
)

target_compile_definitions(Utilities PRIVATE UTILITIES_BUILD_DLL)

方案优势 #

• 彻底解决多DLL依赖时的导入导出冲突问题，每个库的导入导出状态完全独立
• 代码可读性更强，通过宏名称就能明确知道属于哪个库
• 兼容CMake的依赖管理，不需要手动在源文件中切换宏状态

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