使用 dllimport/dllexport 宏在多个项目中包含标头时出现 VC++ 链接器错误答案

【问题标题】：VC++ linker error when using dllimport/dllexport macro to include headers in multiple projects使用 dllimport/dllexport 宏在多个项目中包含标头时出现 VC++ 链接器错误
【发布时间】：2018-09-07 02:46:24
【问题描述】：

我有一个 Visual C++ 解决方案，使用 Visual Studio 2017，其中包含 5 个项目：

SpikeConfig
SpikeEngine
SpikeRenderer
SpikeUI
SpikeUtils

在 SpikeUtils 中，我有一个标头 _SpikeEngineObject.h：

#pragma once

#ifdef DLL_SPIKEUTILS
#define SPIKEUTILS_EXPORT __declspec(dllexport)
#else
#define SPIKEUTILS_EXPORT __declspec(dllimport)
#endif

#include "GUID.h"

namespace SpikeUtils
{
    class SPIKEUTILS_EXPORT _SpikeEngineObject
    {
    public:
        const std::string & _SpikeEngineId()
        {
            return _SpikeRef.Value();
        }
    private:
        SpikeUtils::GUID _SpikeRef = SpikeUtils::GUID::Generate();
    };
}

包含的文件 GUID.h 如下所示：

#pragma once

#include <iostream>

#ifdef DLL_SPIKEUTILS
#define SPIKEUTILS_EXPORT __declspec(dllexport)
#else
#define SPIKEUTILS_EXPORT __declspec(dllimport)
#endif

namespace SpikeUtils
{
    class SPIKEUTILS_EXPORT GUID final
    {
    public:
        GUID(GUID const & other) = default;
        GUID& operator=(GUID& other) = default;

        static GUID Generate();
        std::string const & Value();
    private:
        GUID(std::string const & value) : value(value)
        {}
        std::string value;
    };
}

我忽略了 GUID.cpp 的实现，因为我认为它不相关。

现在，在 SpikeUI 中，我有一个 Drawable 类，它只是继承自 _SpikeEngineObject.h

 #pragma once

 #include "_SpikeEngineObject.h"

 #ifdef DLL_SPIKEUI
 #define SPIKEUI_EXPORT __declspec(dllexport)
 #else
 #define SPIKEUI_EXPORT __declspec(dllimport)
 #endif

 namespace SpikeUI
 {
     namespace UI
     {
         struct SPIKEUI_EXPORT Drawable : SpikeUtils::_SpikeEngineObject
         {
             ....
         };
     }
 }

显然，所有相应的 DLL_ 定义都已放入每个单独项目的 C/C++ -> 预处理器 -> 预处理器定义中，因此项目应使用适当的 dllimport / dllexport 宏构建。

但是当我尝试构建 SpikeUI 时，我会收到如下链接器错误：

LNK2019 unresolved external symbol "__declspec(dllimport) public: __cdecl 
SpikeUtils::_SpikeEngineObject::_SpikeEngineObject(void)" (__imp_?? 
0_SpikeEngineObject@SpikeUtils@@QEAA@XZ) referenced in function "public: 
__cdecl SpikeUI::UI::Drawable::Drawable(enum SpikeUI::UI::DrawableType)" (?? 
0Drawable@UI@SpikeUI@@QEAA@W4DrawableType@12@@Z)

和

LNK2019 unresolved external symbol "__declspec(dllimport) public: __cdecl 
SpikeUtils::_SpikeEngineObject::~_SpikeEngineObject(void)" (__imp_?? 
1_SpikeEngineObject@SpikeUtils@@QEAA@XZ) referenced in function "int 
`public: __cdecl SpikeUI::UI::Drawable::Drawable(struct UI::Drawable::dtor$0 
const &)'::`1'::dtor$0" (?dtor$0@?0???0Drawable@UI@SpikeUI@@QEAA@AEBU012@@Z@4HA)

一个有趣的事实是，Visual Studio 甚至会突出显示将使用的宏，例如 GUID.h 确实会突出显示 dllexport 宏，但 _SpikeEngineObject.h 出于某种原因会突出显示 dllimport 宏。

通过 SO 和 MSDN 搜索，看起来这个宏模式应该可以工作，但由于某种原因，它与我的项目不一致。

如何解决链接器错误？

【问题讨论】：

宏汤确实看起来很受尊重，链接器错误显示“dllimport”。显然你忘了告诉链接器在链接spikeui项目时需要链接spikeutils.lib。添加到spikeui项目的References节点。
@HansPassant 它也与 .lib 链接。如果我没有在其中使用宏，而是直接在任何地方使用 __declspec(dllexport)，程序构建和运行都很好。
你确定你已经为正确 Platform / Configuration设置了宏定义（在项目设置中） > tuple（你正在构建的那个）？ stackoverflow.com/questions/44124452/…
@CristiFati 是的。我已经为所有配置设置了宏。所以包括调试和发布以及 x64，这就是我构建的基础

标签： c++ linker dllimport dllexport unresolved-external

【解决方案1】：

在这里回答我自己的问题：

SpikeUI 项目依赖于 SpikeUtils 项目，它与构建 SpikeUtils 输出的 .lib 和 .dll 项目相关联 项目。

现在，问题在于类 _SpikeEngineObject 是一个只有标头的类（即该类没有 .cpp）。因此，我假设 SpikeUtils.lib 不包含 _SpikeEngineObject 的构造函数/析构函数等的任何符号，因此链接器在链接它时遇到问题。

我通过为类添加一个 .cpp 文件并实现哑构造函数/析构函数来解决问题，以便编译器生成这些符号，一切都很好。

【讨论】：