在C#项目开发中，默认编译模式下，即使代码没有发生任何修改，两次编译生成的程序集往往也会存在二进制差异，这是因为编译过程会嵌入时间戳、随机生成的模块版本ID等不确定信息。如果需要实现两次编译生成完全相同的程序集，就需要通过确定性构建来消除这些不确定因素。
什么是C#确定性构建
确定性构建指的是在相同的输入条件下，无论编译的时间、环境、执行的机器如何变化，编译器都能生成完全相同的二进制输出。对于C#来说，确定性构建需要保证程序集的元数据、IL代码、资源文件等内容在两次编译中完全一致，不存在任何随机或时间相关的差异。
默认编译的不确定因素
默认情况下C#编译会引入以下几类不确定信息，导致程序集无法保持一致：
- 程序集元数据中的
MVID（模块版本ID），默认是随机生成的GUID - 程序集的编译时间戳，会记录编译执行的具体时间
- 如果项目包含嵌入的资源文件，部分资源的生成也可能引入随机信息
- 如果使用了
AssemblyVersion等属性的动态生成规则，也可能导致版本信息变化
实现确定性构建的配置方法
1. 启用编译器确定性构建选项
从.NET Core 2.1和MSBuild 15.3开始，编译器提供了Deterministic选项，开启后编译器会消除大部分随机和时间相关的编译差异。可以在项目文件（.csproj）中添加以下配置：
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net8.0</TargetFramework>
<!-- 启用确定性构建 -->
<Deterministic>true</Deterministic>
<!-- 启用确定性资源，避免资源生成引入随机信息 -->
<DeterministicSourcePaths>true</DeterministicSourcePaths>
</PropertyGroup>
</Project>
其中Deterministic选项会让编译器使用固定的算法生成MVID，不再嵌入编译时间戳；DeterministicSourcePaths会将源文件路径标准化，避免不同机器上路径不同导致编译差异。
2. 固定程序集版本信息
默认的AssemblyInfo.cs中可能会使用动态生成的版本号，或者依赖编译时间生成版本信息，需要手动固定版本信息。可以在项目文件中直接指定版本，避免自动生成：
<PropertyGroup> <AssemblyVersion>1.0.0.0</AssemblyVersion> <FileVersion>1.0.0.0</FileVersion> <Version>1.0.0</Version> </PropertyGroup>
注意不要使用类似[assembly: AssemblyVersion("1.0.*")]这样的通配符配置，通配符会让编译时自动生成版本号的后两位，导致两次编译结果不同。
3. 处理嵌入资源和外部依赖
如果项目中包含嵌入的资源文件，需要确保资源文件本身的内容在两次编译之间没有变化，并且资源的生成过程没有引入随机信息。对于外部依赖的NuGet包，需要固定依赖包的版本，避免不同时间拉取不同版本的依赖导致程序集差异。
可以在项目文件中固定NuGet包版本，例如：
<ItemGroup> <PackageReference Include="Newtonsoft.Json" Version="13.0.3" /> </ItemGroup>
验证编译结果是否一致
完成上述配置后，可以通过对比两次编译生成的程序集文件来验证是否一致。可以使用文件哈希工具计算两个程序集的SHA256值，如果哈希值完全相同，说明两次编译生成了完全相同的程序集。
以下是C#中计算文件哈希的示例代码：
using System.Security.Cryptography;
using System.IO;
public class HashHelper
{
public static string GetFileSha256(string filePath)
{
using (var stream = File.OpenRead(filePath))
using (var sha256 = SHA256.Create())
{
var hashBytes = sha256.ComputeHash(stream);
return BitConverter.ToString(hashBytes).Replace("-", "").ToLowerInvariant();
}
}
}
// 使用方式
var hash1 = HashHelper.GetFileSha256("第一次编译的路径/bin/Debug/net8.0/test.dll");
var hash2 = HashHelper.GetFileSha256("第二次编译的路径/bin/Debug/net8.0/test.dll");
Console.WriteLine(hash1 == hash2 ? "程序集完全相同" : "程序集存在差异");
常见注意事项
- 如果项目使用了代码生成工具，需要确保代码生成工具的输出是确定性的，不会因为执行时间或环境变化产生不同结果
- 编译环境的.NET SDK版本需要保持一致，不同版本的编译器可能存在行为差异，导致输出不同
- 如果启用了增量编译，需要确保增量编译的逻辑不会引入额外的不确定信息，一般开启确定性构建后增量编译也不会影响结果一致性
确定性构建不仅适用于需要校验程序集一致性的场景，也可以提升增量构建的效率，因为编译器可以通过对比输入是否变化来决定是否需要重新编译，减少不必要的编译操作。