在MFC中使用Qt（三）：通过编辑项目文件（.vcxproj）实现Qt的自动化编译流程

前言

回顾下前面介绍的：
在MFC中使用Qt（一）：玩腻了MFC，试试在MFC中使用Qt！（手动配置编译Qt）

在MFC中使用Qt（二）：实现Qt文件的自动编译流程

本文将详细介绍方式二：通过编辑项目文件（.vcxproj）实现自动化Qt编译流程。

通过编辑项目文件（.vcxproj）实现自动化Qt编译流程

这里再新建一个MFC对话框项目MFCWithQtAuto2，尝试方式二。

新建MFCWithQtAuto2，编译运行确认没有问题：

步骤①配置Qt环境（必不可少！）

步骤②配置项目

因为不像在MFC中使用Qt（二）：实现Qt文件的自动编译流程那样，将项目标记成Qt项目，编辑项目文件（.vcxproj）实现自动化Qt编译流程方式，本质还是MFC项目。

因此在项目属性中添加要使用的本地Qt模块的包含目录、附件库目录和库文件：

配置完成后，编译运行，确认没有问题：

接着编辑项目文件（.vcxproj），代替手动编译流程中的③④步骤

①编辑项目文件（.vcxproj）

右键项目 → Unload Project：

在最后一个后面追加以下内容：

xml 复制代码

  <!-- 自动包含 所有目录下的 .ui 、moc、qrc文件 -->
  <ItemGroup>
    <UIFiles Include="**\*.ui" />
  </ItemGroup>
  <!-- 自定义构建步骤，编译 .ui 文件为 .h 文件 -->
  <ItemGroup>
    <CustomBuild Include="@(UIFiles)">
      <Command>"uic.exe" %(FullPath) -o $(ProjectDir)GeneratedFiles\uic\ui_%(Filename).h</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\ui_%(Filename).h</Outputs>
    </CustomBuild>
  </ItemGroup>
  <!-- 自动包含 所有目录下的 带Q_OBJECT宏的.h 文件。因无法区分普通的C++.h，因此需要在一个目录（这里是qt/UI目录）中统一管理 -->
  <ItemGroup>
    <MocFiles Include="$(ProjectDir)qt\UI\*.h" />
  </ItemGroup>
  <ItemGroup>
    <CustomBuild Include="@(MocFiles)">
      <Command>"moc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\moc\moc_%(Filename).cpp"</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\moc_%(Filename).cpp</Outputs>
    </CustomBuild>
  </ItemGroup>
  <ItemGroup>
    <!-- 自动包括所有的 .qrc 文件 -->
    <QrcFiles Include="**\*.qrc" />
  </ItemGroup>
  <ItemGroup>
    <CustomBuild Include="@(QrcFiles)">
      <Command>"rcc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\rcc\qrc_%(Filename).cpp"</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\qrc_%(Filename).cpp</Outputs>
    </CustomBuild>
  </ItemGroup>
  <ItemGroup>
    <ClCompile Include="$(ProjectDir)GeneratedFiles\moc\moc_*.cpp">
      <PrecompiledHeader>NotUsing</PrecompiledHeader>
    </ClCompile>
    <ClCompile Include="$(ProjectDir)GeneratedFiles\rcc\qrc_*.cpp">
      <PrecompiledHeader>NotUsing</PrecompiledHeader>
    </ClCompile>
  </ItemGroup>

这里逐个解析一下这段配置作用：

1）处理 UI 文件（.ui → .h）

xml 复制代码

<ItemGroup>
  <UIFiles Include="**\*.ui" /> <!-- 扫描所有目录下的 .ui 文件 -->
</ItemGroup>

<ItemGroup>
  <CustomBuild Include="@(UIFiles)">
    <Command>"uic.exe" %(FullPath) -o $(ProjectDir)GeneratedFiles\uic\ui_%(Filename).h</Command>
    <Outputs>$(ProjectDir)GeneratedFiles\ui_%(Filename).h</Outputs>
  </CustomBuild>
</ItemGroup>

作用：使用 uic.exe（Qt UI 编译器）将 .ui 文件转换为 ui_*.h 头文件。

输出路径：GeneratedFiles\uic\ 目录下生成 ui_文件名.h。

示例：MDialog.ui → GeneratedFiles\uic\ui_MDialog.h

2）处理 MOC 文件（含 Q_OBJECT 的 .h → .cpp）

xml 复制代码

<ItemGroup>
  <MocFiles Include="$(ProjectDir)qt\UI\*.h" /> <!-- 仅扫描 qt\UI 目录下的头文件 -->
</ItemGroup>

<ItemGroup>
  <CustomBuild Include="@(MocFiles)">
    <Command>"moc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\moc\moc_%(Filename).cpp"</Command>
    <Outputs>$(ProjectDir)GeneratedFiles\moc_%(Filename).cpp</Outputs>
  </CustomBuild>
</ItemGroup>

作用：使用 moc.exe（Qt 元对象编译器）处理含 Q_OBJECT 宏的头文件，生成 moc_*.cpp 元对象代码。

输出路径：GeneratedFiles\moc\ 目录下生成 moc_文件名.cpp。

限制：仅处理 qt\UI （后续应用替换成自己项目指定的目录）目录下的头文件，避免扫描无关文件（如系统头文件）。

示例：qt/UI/MWidget.h → GeneratedFiles\moc\moc_MDialog.cpp

3）处理资源文件（.qrc → .cpp）

xml 复制代码

<ItemGroup>
  <QrcFiles Include="**\*.qrc" /> <!-- 扫描所有目录下的 .qrc 文件 -->
</ItemGroup>

<ItemGroup>
  <CustomBuild Include="@(QrcFiles)">
    <Command>"rcc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\rcc\qrc_%(Filename).cpp"</Command>
    <Outputs>$(ProjectDir)GeneratedFiles\rcc\qrc_%(Filename).cpp</Outputs>
  </CustomBuild>
</ItemGroup>

作用：使用 rcc.exe（Qt 资源编译器）将 .qrc 文件编译为 qrc_*.cpp，嵌入二进制资源（如图标、字体）。

输出路径：GeneratedFiles\rcc\ 目录下生成 qrc_文件名.cpp。

示例：resources.qrc → GeneratedFiles\rcc\qrc_resources.cpp

4）自动包含生成的文件到编译

xml 复制代码

<ItemGroup>
  <ClCompile Include="$(ProjectDir)GeneratedFiles\moc\moc_*.cpp">
    <PrecompiledHeader>NotUsing</PrecompiledHeader>
  </ClCompile>
  <ClCompile Include="$(ProjectDir)GeneratedFiles\rcc\qrc_*.cpp">
    <PrecompiledHeader>NotUsing</PrecompiledHeader>
  </ClCompile>
</ItemGroup>

作用：将生成的 moc_.cpp 和 qrc_ .cpp 文件自动包含到项目编译中。

关键设置：<PrecompiledHeader>NotUsing</PrecompiledHeader> 表示这些文件不使用预编译头文件。

5）输出路径管理

所有生成的文件统一存放在 GeneratedFiles 目录的子文件夹中：

复制代码

GeneratedFiles/
├── uic/         # UI 生成的头文件（ui_*.h）
├── moc/         # MOC 生成的元对象代码（moc_*.cpp）
└── rcc/         # 资源文件生成的代码（qrc_*.cpp）

优点：避免生成文件污染源码目录，便于版本控制忽略（通过 .gitignore 排除 GeneratedFiles）。

卸载项目并添加到项目配置文件中，位置在最后一个后追加：

重新加载项目，新建Qt类MDialog。

注意新建的文件会自动放在项目根目录，这里需要手动剪切到上面项目配置文件中指定的目录下：

同样在项目中添加同目录结构一样的筛选器：

虽然这里也要手动处理，但及时在正经的Qt项目中，也会在一个目录/筛选器中维护管理Qt类文件，因此不算是之前手动编译涉及的问题。

编译运行，同样没有毛病！！！

至此，通过编辑项目文件（.vcxproj）也能够解决手动编译问题：

①每次新建/添加的Qt文件，都需要手动配置自定义生成工具以添加Qt编译工具的编译流程。

②通过Qt编译工具编译输出的文件，需要手动添加到项目中。

实现Qt编译流程自动化！！！

总结

编辑项目文件（.vcxproj）实现自动化Qt编译流程方式，本质还是MFC项目。

因此相较于在MFC中使用Qt（二）：实现Qt文件的自动编译流程

还是需要在项目属性中添加要使用的本地Qt模块的包含目录、附件库目录和库文件。

补充

Qt编译工具输出的.h头文件目录，需要手动配置包含目录：

当然也可以在配置文件中添加处理：

xml 复制代码

<AdditionalIncludeDirectories>GeneratedFiles\uic;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>

添加后的完整配置：

xml 复制代码

<!-- 自动包含 所有目录下的 .ui 、moc、qrc文件 -->
  <ItemGroup>
    <UIFiles Include="**\*.ui" />
  </ItemGroup>
  <!-- 自定义构建步骤，编译 .ui 文件为 .h 文件 -->
  <ItemGroup>
    <CustomBuild Include="@(UIFiles)">
      <Command>"uic.exe" %(FullPath) -o $(ProjectDir)GeneratedFiles\uic\ui_%(Filename).h</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\ui_%(Filename).h</Outputs>
    </CustomBuild>
  </ItemGroup>
  <!-- 自动包含 所有目录下的 带Q_OBJECT宏的.h 文件。因无法区分普通的C++.h，因此需要在一个目录（这里是qt/UI目录）中统一管理 -->
  <ItemGroup>
    <MocFiles Include="$(ProjectDir)qt\UI\*.h" />
  </ItemGroup>
  <ItemGroup>
    <CustomBuild Include="@(MocFiles)">
      <Command>"moc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\moc\moc_%(Filename).cpp"</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\moc_%(Filename).cpp</Outputs>
    </CustomBuild>
  </ItemGroup>
  <ItemGroup>
    <!-- 自动包括所有的 .qrc 文件 -->
    <QrcFiles Include="**\*.qrc" />
  </ItemGroup>
  <ItemGroup>
    <CustomBuild Include="@(QrcFiles)">
      <Command>"rcc.exe" "%(FullPath)" -o "$(ProjectDir)GeneratedFiles\rcc\qrc_%(Filename).cpp"</Command>
      <Outputs>$(ProjectDir)GeneratedFiles\qrc_%(Filename).cpp</Outputs>
    </CustomBuild>
  </ItemGroup>
  <ItemGroup>
    <ClCompile Include="$(ProjectDir)GeneratedFiles\moc\moc_*.cpp">
      <PrecompiledHeader>NotUsing</PrecompiledHeader>
    </ClCompile>
    <ClCompile Include="$(ProjectDir)GeneratedFiles\rcc\qrc_*.cpp">
      <PrecompiledHeader>NotUsing</PrecompiledHeader>
    </ClCompile>
  </ItemGroup>
  <ItemDefinitionGroup>
    <ClCompile>
      <!-- 添加新路径到现有包含目录列表 -->
      <AdditionalIncludeDirectories>GeneratedFiles\uic;%(AdditionalIncludeDirectories)</AdditionalIncludeDirectories>
    </ClCompile>
  </ItemDefinitionGroup>

当然目前的配置都是默认Release x64环境，没有做Debug、Release，x64、x86的区分，若有需要可自行修改调整。