.Net 5中能否组合Deterministic与PublishSingleFile生成确定性单文件程序集

失效原因 #

PublishSingleFile 选项默认在打包过程中会引入时间戳、随机生成的包标识等非确定性输入，因此直接和 Deterministic=true 共用时会导致输出哈希不一致。这两个功能本身不存在互斥，只要补充额外的配置项消除打包过程的非确定性因素即可同时生效。

解决配置方案 #

在你的项目 .csproj 文件的 <PropertyGroup> 节点中添加以下配置：

<!-- 基础配置 -->
<Deterministic>true</Deterministic>
<PublishSingleFile>true</PublishSingleFile>
<RuntimeIdentifier>win-x64</RuntimeIdentifier> <!-- 替换为你实际需要的RID -->
<SelfContained>true</SelfContained> <!-- 按需选择是否为独立部署 -->

<!-- 消除非确定性因素的额外配置 -->
<DeterministicSourcePaths>true</DeterministicSourcePaths>
<SingleFileBundleDeterministic>true</SingleFileBundleDeterministic>
<DebugType>portable</DebugType>
<EmbedAllSources>false</EmbedAllSources>
<!-- 固定程序集版本，禁止自动生成带时间戳的版本号 -->
<GenerateAssemblyVersionAttribute>false</GenerateAssemblyVersionAttribute>
<GenerateFileVersionAttribute>false</GenerateFileVersionAttribute>
<AssemblyVersion>1.0.0.0</AssemblyVersion>
<FileVersion>1.0.0.0</FileVersion>

构建注意事项 #

• 所有构建流程使用完全相同的 .NET SDK 版本，避免不同版本打包逻辑差异导致输出不一致
• 构建过程不要引入动态生成的源代码、资源文件等可变输入
• 若不需要调试符号，可额外添加 <IncludeSymbols>false</IncludeSymbols> 进一步降低非确定性风险

配置完成后多次执行 dotnet publish 命令，即可得到哈希完全一致的单文件可执行程序。

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