如果你干预到了项目的编译过程，可能就需要考虑到差量编译了。不然——当你的项目大起来的时候，就会感受到每次都重新编译时，每次重复调试的过程都要进行漫长等待时的绝望和无奈。
如果你正遭遇差量编译失效，每次都要重新编译的问题，那么阅读本文应该能够帮助你解决问题。
msbuild.exe 和 dotnet build 编译项目的方式是一样的，只不过前者使用完整的 .NET Framework，而后者使用 .NET Core。所以后面我们说到 Target 的差量编译的时候，就不再区分这两者了。
一个差量编译的例子
先看一个 Target 的例子，这里例子来源于我的另一篇文章如何创建一个基于 MSBuild Task 的跨平台的 NuGet 工具包 - 吕毅。在例子中，我没有加入任何的差量编译支持。
1
2
3
4
<Target Name="WalterlvDemo" BeforeTargets="CoreCompile"
Inputs="$(MSBuildAllProjects);@(Compile)" Outputs="$(IntermediateOutputPath)Doubi.cs">
<Exec Command="dotnet walterlv-tool.dll $(IntermediateOutputPath)Doubi.cs" />
</Target>
上述例子的作用是在编译期间执行一个名为 walterlv-tool.dll 的 .NET Core 应用，在命令执行结束之后，将生成一份新的代码文件 $(IntermediateOutputPath)Doubi.cs 并加入编译。
如果你觉得上面的写法非常陌生，或者说不清楚那个 Target 节点的作用，建议先阅读：
差量编译的关键
每一个 Target 都有 Inputs 和 Outputs 属性，可以设置，也可以不用设置。
- 当两者都没有指定时，MSBuild 会认定为此
Target在每次编译时都会执行 - 当两者都指定时，MSBuild 会认定为此
Target需要进行差量执行 - 不能只指定其中的一个而不指定另一个（MSBuild 直接会提示此 Target 没有正确指定
Inputs和Outputs）
另外，Inputs 和 Outputs 必须指定为文件或文件的集合。因为差量编译的判定规则是 “文件存在，且前后两次编译的大小和修改时间相同”。
Inputs 和 Outputs 的格式都是一组用 ; 分隔的字符串，每一项都是一个文件的路径。不过不用特别考虑如何使用 ; 拼接，因为当我们使用 @ 符号时，收集到的每一项便是使用 ; 分隔的。例如 @(Compile) 表示在 <ItemGroup> 中每一个 Compile 类型的节点。如果不清楚 <ItemGroup> 和 <Compile> 的作用，建议建议先阅读理解 C# 项目 csproj 文件格式的本质和编译流程 - 吕毅。
假设我们指定 Inputs 为 @(Compile)，Outputs 指定为某个 xxx.exe 生成的临时文件的位置（在 如何创建一个基于命令行工具的跨平台的 NuGet 工具包 一文中，我假定为了 $(IntermediateOutputPath)Doubi.cs），那么 MSBuild 就会在执行此 Target 之前检查所有这些输入输出文件。如果所有 <Compile> 节点中对应的文件都没有改变，而且 $(IntermediateOutputPath)Doubi.cs 存在且没改变，那么此 Target 将不需要执行。任何一个文件不满足此条件，则 Target 都将重新执行。
不是所有的 Target 都适合差量编译
注意！不是所有的 Target 都适合设置 Inputs 和 Outputs 属性！
在本文前面的例子中，我们的 Target 是有明确的输入和输出文件的；然而有些 Target 是没有输入输出文件的——他们的输出依赖于其他 Target 的输出。
例如我们有另一个 <Target>，它的作用是生成一个属性的值，或者一组文件的名字；而另外一个 <Target> 使用这个属性的值和这组文件。典型的例子如我在如何创建一个基于命令行工具的跨平台的 NuGet 工具包 中写的那个 NuGet 工具。
1
2
3
4
5
6
7
8
9
10
<Target Name="WalterlvDemo" BeforeTargets="CoreCompile"
Inputs="$(MSBuildAllProjects);@(Compile)" Outputs="$(IntermediateOutputPath)Doubi.cs">
<Exec Command="dotnet walterlv-tool.dll $(IntermediateOutputPath)Doubi.cs" />
</Target>
<Target Name="WalterlvDemoUseResult" AfterTargets="WalterlvDemo" BeforeTargets="CoreCompile">
<ItemGroup>
<Compile Include="$(IntermediateOutputPath)Doubi.cs" />
</ItemGroup>
</Target>
WalterlvDemo 生成文件，而 WalterlvDemoUseResult 使用文件。这时，WalterlvDemo 适合使用差量编译，而 WalterlvDemoUseResult 却不适合！
因为前者已经生成了文件，如果不执行，文件依然存在；但后者一旦不执行，那么我们就会少一个编译的文件。这将导致后续名为 CoreCompile 的 Target 执行时，发现少了一个文件，将重新执行编译。
所以前者的 Inputs 指定为空字符串，Outputs 指定为 $(IntermediateOutputPath)Doubi.cs；但是后者不应该指定 Inputs 和 Outputs。
本文会经常更新，请阅读原文： https://blog.walterlv.com/post/msbuild-incremental-build.html ，以避免陈旧错误知识的误导，同时有更好的阅读体验。
本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布，但务必保留文章署名 吕毅 （包含链接： https://blog.walterlv.com ），不得用于商业目的，基于本文修改后的作品务必以相同的许可发布。如有任何疑问，请 与我联系 ([email protected]) 。