c++ - LNK2001 在 VS 2013 (MSVC 18) 但不是在 VS 2015 (MSVC 19)

Question

我使用较早版本的 Cocos2dx 编写游戏并使用 VS 2013 对其进行编译。请注意，我使用的是 CMake 和 Qt Creator 以及两个编译器版本。当 Cocos2dx v3.12 出来时，我决定在我的游戏中将 lib 升级到那个版本并开始使用 VS 2015。然后我开始收到这个错误:

QCardManager.cpp.obj:-1: error: LNK2001: unresolved external symbol "public: static class QCard * __cdecl QCard::create(enum PLAYER,struct Question const *,enum CARD_TYPE,int const &)" (?create@QCard@@SAPAV1@W4PLAYER@@PBUQuestion@@W4CARD_TYPE@@ABH@Z)

而且我在使用 VS 2013 时没有出现该错误。经过几个小时的调试，我找到了原因。

这是 QCard 的粗略减法:

#include "2d/CCSprite.h"
#include "CommonVariables.h"

class RandomPostureSprite;
class Question;
namespace cocos2d
{
class Label;
}

enum class CARD_TYPE {
    QUESTION,
    OPTION
};

class QCard : public cocos2d::Sprite
{
public:
    static QCard *create(PLAYER player, const Question *question, CARD_TYPE type, const int &index);
}

我在 QCard.cpp 中正确实现了该功能文件，并且该文件也已正确添加到项目中。所以问题是 class Question;前向声明。我包括了 QuestionParser.h文件在 QCard.cpp但是因为我对 QCard 使用了前向声明在 QCard.h , QCardManager.cpp文件没有 Question 的实现因此出现链接器错误。

这是我的问题:我意识到 VS 2015 所做的应该是预期的行为。但是为什么会发生这种行为呢？相同的代码在 VS 2013 上编译没有错误，但在 VS 2015 上没有编译错误。我阅读了 Breaking Changes in Visual C++ 2015指导，看不到任何相关内容。

编辑 1:结果前向声明应该是 struct Question而不是 class Question .当我尝试使用 QCard::create在 QCardManager.cpp我收到上述链接器错误。但不在TimerHUD.cpp ，它位于同一目录中。我将发布它们的摘要内容。请记住，我保留了 QCard 的声明。与此编辑相同。

Question 结构，位于 QuestionParser.h 中:

struct Question {
    Question()
        : type()
        , source()
        , alias()
        , color(0, 0, 0)
    {}
};

QCardManager.h

// Cocos2dx
#include "math/Vec2.h"
#include "math/CCGeometry.h"
// Utilities
#include "CommonVariables.h"
// Local
#include "GameDefinitions.h"
#include "QuestionParser.h"// This has the Question struct

// Forward declerations
class QCard;
namespace cocos2d
{
class Layer;
class Sprite;
}

class QCardManager
{
}

QCardManager.cpp

#include "QCardManager.h"
// Local
#include "QCard.h"
#include "RandomPostureSprite.h"
// Utilities
#include "GameManager.h"
#include "GameSettings.h"
#include "CocosUtils.h"
// Cocos2dx
#include "cocos2d.h"
using namespace cocos2d;

QCardManager::QCardManager(PLAYER player, Layer &parent)
{
    // This line gives the linker error
    QCard::create(PLAYER::PLAYER_ONE, nullptr, CARD_TYPE::QUESTION, 1);
}

QCardManager引发链接器错误。但是TimerHUD才不是。我现在正在分享内容。

TimerHUD.h

// Cocos2dx
#include "2d/CCNode.h"

namespace cocos2d
{
class Sprite;
class Label;
}

class TimerHUD : public cocos2d::Node
{
}

TimerHUD.cpp

// Cocos2dx
#include "cocos2d.h"
#include "SimpleAudioEngine.h"
// Local
#include "GameDefinitions.h"
// Utilities
#include "GameManager.h"
#include "GameSettings.h"
#include "CocosUtils.h"
#include "QCard.h"
using namespace cocos2d;

TimerHUD::TimerHUD()
{
    // This does not raise the linker error
    QCard::create(PLAYER::PLAYER_ONE, nullptr, CARD_TYPE::QUESTION, 1);
}

Answer 1

您不需要Question 的定义来正确链接。 @PBUQuestion@ 中的 U 和链接器错误似乎在谈论 struct Question 而不是 class Question，所以Question 的声明和定义不匹配。如果您要提高警告级别，您会看到:

> type a.cpp
struct A;
class A {};

> cl /Wall a.cpp
Microsoft (R) C/C++ Optimizing Compiler Version 19.00.24213.1 for x86
Copyright (C) Microsoft Corporation.  All rights reserved.

a.cpp
a.cpp(2): warning C4099: 'A': type name first seen using 'struct' now seen using 'class'
a.cpp(2): note: see declaration of 'A'

但是因为您的警告级别太低，所以您没有得到该诊断。

您的代码似乎从 standard's point of view 开始有效.来自 C++11 9.1/2:

A declaration consisting solely of class-key identifier; is either a redeclaration of the name in the current scope or a forward declaration of the identifier as a class name. It introduces the class name into the current scope.

但是，Visual C++ 根据名称是 class 还是 struct 对函数名称进行不同的处理:

> undname ?f@@YAXPAUA@@@Z
void __cdecl f(struct A *)

> undname ?f@@YAXPAVA@@@Z
void __cdecl f(class A *)

请注意，struct 被分解为 U，class 被分解为 V。这是 definitely a bug in Visual C++ ，它不应该区别对待 class 和 struct。

一旦理解了这一点，您的错误就很容易重现:

> type a.cpp
class A;          // declares A as a class
void f(A* a);     // declares f(class A*)

int main()
{
    f(nullptr);   // calls f(class A*)
}


> type b.cpp
struct A {};      // defines A as a struct, mismatch!
void f(A* a) {}   // defines f(struct A*)!


> cl /nologo a.cpp b.cpp
a.cpp
b.cpp
Generating Code...
a.obj : error LNK2019: unresolved external symbol
    "void __cdecl f(class A *)" (?f@@YAXPAVA@@@Z) referenced
        in function _main
a.exe : fatal error LNK1120: 1 unresolved externals

所以你遇到这些奇怪问题的原因是因为行为取决于特定的 translation unit (基本上，.cpp)将 Question 视为 class 或 struct。这又取决于包含哪些 header 。

请注意，您需要在不同的翻译单元中出现不匹配。在同一单元内，Visual C++ will use the the class-key from the definition ，即使之前有不同的声明:

Compiler Warning (level 2) C4099

'identifier' : type name first seen using 'objecttype1' now seen using 'objecttype2'

An object declared as a structure is defined as a class, or an object declared as a class is defined as a structure. The compiler uses the type given in the definition.

至于这在 Visual C++ 2013 中不是问题的原因，我怀疑 mangling scheme 最近发生了变化。听起来这个错误已经存在了since at least 6.0 .您可能无意中更改了包含的顺序。