[QT]VS中Qt自动生成moc_XXX.cpp文件的一些问题

原创文章，欢迎转载。转载请注明：转载自 祥的博客

原文链接：https://cloud.tencent.com/developer/article/1596355

• 1.问题来源
• 2.错误LNK2001 以及解决
• 3.警告LNK4042 以及解决
• 4.反思

1.问题来源

Qt会自己先把用到Qt自己的东西编译一遍，变成标准C++编译器可以识别的东西。

moc 全称是 Meta-Object Compiler，也就是“元对象编译器”。Qt 程序在交由标准编译器编译之前，先要使用 moc 分析 C++ 源文件。如果它发现在一个头文件中包含了宏 Q_OBJECT，则会生成另外一个 C++ 源文件。这个源文件中包含了 Q_OBJECT 宏的实现代码。这个新的文件名字将会是原文件名前面加上 moc_ 构成。这个新的文件同样将进入编译系统，最终被链接到二进制代码中去。因此我们可以知道，这个新的文件不是“替换”掉旧的文件，而是与原文件一起参与编译。另外，我们还可以看出一点，moc 的执行是在预处理器之前。因为预处理器执行之后，Q_OBJECT 宏就不存在了。

我一直用Release|Win32模式进行开发，基本都用qDebug()进行调试，一般不会在Debug模式下进行调试，有一次手残（or NC），把Generated/Debug 下的moc_XXX.cpp全删除了（是在VS的工程项目中删除的，在文件夹中删除了，无所谓，每次编译的时候，会自动moc，这个过程是你XXX.cpp文件的设置）。

不知道是多久之前，干的蠢事，Release模式下，各种OK，突然要用Debug模式了，发现编译不过，然后引发各种问题，下面将解决的过程进行还原（降低了挑战难度，表情：笑着哭）

2.错误LNK2001 以及解决

当我删除Generated/Debug 中的 moc_bridge.cpp 时，在Release模式下，编译运行都没什么影响，但是在切换到Debug后，链接生成exe就会报错，熟悉的error LNK2001，就是说删除的moc_bridge.cpp 才会把bridge.cpp里面的函数生成为.obj文件，所以不能删除。

1>bridge.obj : error LNK2001: 无法解析的外部符号 “public: virtual struct QMetaObject const * __thiscall bridge::metaObject(void)const ” (?metaObject@bridge@@UBEPBUQMetaObject@@XZ) 1>bridge.obj : error LNK2001: 无法解析的外部符号 “public: virtual void * __thiscall bridge::qt_metacast(char const *)” (?qt_metacast@bridge@@UAEPAXPBD@Z) 1>bridge.obj : error LNK2001: 无法解析的外部符号 “public: virtual int __thiscall bridge::qt_metacall(enum QMetaObject::Call,int,void * *)” (?qt_metacall@bridge@@UAEHW4Call@QMetaObject@@HPAPAX@Z)

那么我直接将删除的moc_bridge.cpp文件添加进Generated/Debug 中，这样Debug模式下，程序就可以正常的编译运行了。

3.警告LNK4042 以及解决

但是！在Release模式下编译链接，会出现一个Warning：

1>C:\Program Files (x86)\MSBuild\Microsoft.Cpp\v4.0\V120\Microsoft.CppBuild.targets(942,5): warning MSB8027: Two or more files with the name of moc_bridge.cpp will produce outputs to the same location. This can lead to an incorrect build result. The files involved are GeneratedFiles\Debug\moc_bridge.cpp, GeneratedFiles\Release\moc_bridge.cpp. 1> moc_bridge.cpp 1>Release\moc_bridge.obj : warning LNK4042: 对象被多次指定；已忽略多余的指定

这是因为，参与编译链接的有两个moc_bridge.cpp，一个是Generated/Debug 中的，一个是Generated/Release 中的。但是，这里面有这么多个相同的moc_XXX.cpp，为什么要针对我删除的这个？

经过我呕心沥血的对比查找，发现就是一个设置的问题，需要修改QtWebTest.vcxproj这个文件。

用Notepad++打开（打开前关闭项目，可以使用各种文本编辑器，本人习惯用Notepad++，神器），找到GeneratedFiles\Debug\moc_bridge.cpp对应的部分。

  <ItemGroup>

      ... ...

    <ClCompile Include="GeneratedFiles\Debug\moc_bridge.cpp" />
    <ClCompile Include="GeneratedFiles\Debug\moc_checkConfigPath.cpp">
      <ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">true</ExcludedFromBuild>
    </ClCompile>
    <ClCompile Include="GeneratedFiles\Debug\moc_ComThread.cpp">
      <ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">true</ExcludedFromBuild>
    </ClCompile>

      ... ...



    <ClCompile Include="GeneratedFiles\Release\moc_bridge.cpp">
      <ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">true</ExcludedFromBuild>
      <ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">true</ExcludedFromBuild>
    </ClCompile>
    <ClCompile Include="GeneratedFiles\Release\moc_checkConfigPath.cpp">
      <ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">true</ExcludedFromBuild>
      <ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">true</ExcludedFromBuild>
    </ClCompile>
    <ClCompile Include="GeneratedFiles\Release\moc_ComThread.cpp">
      <ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Debug|Win32'">true</ExcludedFromBuild>
      <ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">true</ExcludedFromBuild>
    </ClCompile>


      ... ...   



  </ItemGroup>

对比可以看出，相较于GeneratedFiles\Debug\moc_checkConfigPath.cpp和GeneratedFiles\Debug\moc_ComThread.cpp，我们主要在乎的对象GeneratedFiles\Debug\moc_bridge.cpp缺少了，一个子节点标签：

<ExcludedFromBuild Condition="'$(Configuration)|$(Platform)'=='Release|Win32'">
true
</ExcludedFromBuild>

这句话是啥意思？翻译成人话就是：

当项目处在Release|Win32模式下，这个GeneratedFiles\Debug\moc_bridge.cpp不进行Build(生成解决方案)，这样就可以理解了，下面的GeneratedFiles\Release\moc_bridge.cpp等文件，也是设定了在Debug|Win32和Debug|x64下，排除Build。

改过之后，No warning。大功告成，Enjoy！

4.反思

排除这个warning的过程其实是很痛苦的，现在看着思路很清晰，但真实情况是各种碰壁，我当初是吧整个GeneratedFiles\Debug 都删除了，根本没有对比的对象(表情:笑着哭)，我是对比一些好的工程，进行分析，除了分析XXXX.vcxproj文件外，还主要分析了文件XXXX.vcxproj.filters。各种碰壁，不过好在机智的解决了问题，这就是不精通Qt编译原理，以及被IDE集成开发环境惯坏了的 传统教训!!!