如何通过AOT编译发布单文件WPF应用程序

可行性说明 #

.NET Framework完全不支持AOT编译，必须切换到**.NET 6及以上版本**（.NET 6开始官方为WPF提供了AOT编译支持），才能实现你的需求。

分步实现指南 #

1. 环境准备

• 安装.NET 6/7/8 SDK（推荐最新稳定版，如.NET 8）
• 安装Visual Studio 2022 17.0及以上版本（或使用dotnet CLI命令行工具）

2. 迁移或创建WPF项目（针对原.NET Framework项目）

如果是现有.NET Framework WPF项目，需迁移到.NET 6+：

• 在Visual Studio中打开项目，右键项目 → 升级项目 → 选择目标.NET版本（如.NET 8）
• 修复迁移过程中出现的兼容性问题（如过时API替换、NuGet包更新）

如果是新项目，直接创建.NET 6+的WPF应用即可。

3. 配置AOT编译与单文件发布

编辑项目的.csproj文件，添加以下配置：

<PropertyGroup>
  <!-- 启用AOT编译 -->
  <PublishAot>true</PublishAot>
  <!-- 打包为单文件 -->
  <PublishSingleFile>true</PublishSingleFile>
  <!-- 压缩单文件（可选） -->
  <EnableCompressionInSingleFile>true</EnableCompressionInSingleFile>
  <!-- 指定发布平台（必须明确x64/x86/arm64，AOT不支持AnyCPU） -->
  <RuntimeIdentifier>win-x64</RuntimeIdentifier>
  <!-- 移除未使用的库（可选，减小体积） -->
  <TrimMode>full</TrimMode>
</PropertyGroup>

4. 执行发布操作

• 使用Visual Studio：右键项目 → 发布 → 选择文件夹目标 → 配置发布配置文件，确保目标运行时选择对应平台（如win-x64），勾选“启用本机AOT”和“生成单文件”，点击发布。
• 使用dotnet CLI：打开命令行，进入项目目录，执行命令：

dotnet publish -c Release -r win-x64 --self-contained true

5. 验证结果

发布完成后，在bin/Release/netX/win-x64/publish目录下，会生成一个独立的.exe文件，直接运行即可，无需依赖.NET运行时。

注意事项 #

• AOT编译会对反射、动态代码生成等特性有限制，若项目中大量使用反射，需添加UnsafeSuppressions.xml文件标记允许的反射操作，或调整代码避免动态特性。
• 单文件AOT编译后的体积会比IL编译的单文件大，但反编译难度显著提升。
• 必须针对特定平台发布（win-x64/x86/arm64），无法跨平台。

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