VS2022下C++ Utils项目MSBuild增量构建配置异常问题

我们团队使用Visual Studio 2022开发C++ Utils项目，通过msbuild命令生成Utils.dll，但重复执行命令会覆盖该文件。为实现增量构建（仅源文件变更时重新生成.dll），配置了如下自定义MSBuild Target：

<Project DefaultTargets="Build" ToolsVersion="14.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
      <ItemGroup>
            <CppFiles Include="Atomic.cpp"/>
            <DllFiles Include="x64\Release\Utils.dll"/>
      </ItemGroup>
      <Target Name = "Build"
            Inputs="@(CppFiles)"
            Outputs="@(DllFiles)">
      </Target>
</Project>

项目简化结构：

• base/Utils
• base/Utils/Atomic.cpp
• base/Utils/x64/Release/Utils.dll

当前未修改源文件时，构建会跳过（不覆盖.dll），符合预期；但修改Atomic.cpp后，Utils.dll并未重新生成，仍为旧版本。注：通过CI工具执行msbuild，而非IDE，且msbuild引用Utils.vcxproj。

解决方案 #

你的自定义Build Target只声明了输入输出的依赖关系，没有包含实际编译生成DLL的执行逻辑——MSBuild能判断何时跳过构建，但触发构建条件时没有实际的编译动作，所以不会更新DLL。

正确配置方式 #

更合理的做法是复用Utils.vcxproj本身的构建逻辑（因为你已经在引用它），让自定义Target依赖VCXProj的默认构建目标，同时关联输入输出：

<Project DefaultTargets="Build" ToolsVersion="17.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <CppFiles Include="Atomic.cpp"/>
    <DllFiles Include="x64\Release\Utils.dll"/>
  </ItemGroup>

  <!-- 导入VCXProj的构建配置 -->
  <Import Project="Utils.vcxproj"/>

  <Target Name="Build" Inputs="@(CppFiles)" Outputs="@(DllFiles)">
    <!-- 调用VCXProj的Build目标完成实际编译 -->
    <MSBuild Projects="Utils.vcxproj" Targets="Build" Properties="Configuration=Release;Platform=x64"/>
  </Target>
</Project>

额外注意事项 #

1. ToolsVersion适配：原配置用了14.0（对应VS2015），你使用VS2022，建议改为17.0或Current，避免版本兼容问题。
2. 路径正确性：确保DllFiles的路径和Utils.vcxproj中配置的输出路径完全一致。
3. 简化方案：如果没有特殊的自定义需求，其实可以直接在CI中执行以下命令，VCXProj默认支持增量构建，会自动判断源码变更并重新生成DLL：

msbuild Utils.vcxproj /p:Configuration=Release /p:Platform=x64

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