如何将.NET 8.0.400版本的WPF项目打包为单个.exe文件

一、用.NET CLI发布（绕开VS配置坑） #

• 先清缓存解决依赖异常
  到项目根目录打开命令行，执行以下命令：

  dotnet clean
  dotnet restore
  

• 执行单文件发布命令
  直接复制下方命令，可根据需求替换win-x64为win-x86或win-arm64：

  dotnet publish -c Release -r win-x64 --self-contained true /p:PublishSingleFile=true /p:IncludeNativeLibrariesForSelfExtract=true /p:EnableCompressionInSingleFile=true /p:EmbedAllResources=true
  

  各参数作用：
  • -c Release：发布正式版本
  • -r win-x64：指定64位Windows目标平台
  • --self-contained true：打包.NET运行时，目标电脑无需提前安装.NET
  • /p:PublishSingleFile=true：生成单个EXE文件
  • /p:IncludeNativeLibrariesForSelfExtract=true：嵌入原生依赖库
  • /p:EnableCompressionInSingleFile=true：压缩单文件包体积
  • /p:EmbedAllResources=true：将项目内图片、XAML等资源全部嵌入EXE
• 定位输出文件
  发布完成后，单EXE文件位于项目目录\bin\Release\net8.0-windows\win-x64\publish路径下。

二、解决你遇到的报错问题 #

• 编织器（Weaver）相关报错：如果项目安装了Fody这类工具，若无需使用可直接卸载对应NuGet包；若必须保留，更新至适配.NET 8的最新稳定版后重新发布。
• 依赖项缺失报错：执行dotnet list package检查所有NuGet包版本，将不兼容.NET 8的包替换为对应新版本，重点排查第三方组件。
• ILMerge失效问题：.NET Core及后续版本官方已不推荐使用ILMerge，直接采用上述原生单文件发布方案即可，无需再折腾ILMerge。

三、运行验证 #

将生成的EXE复制到其他Windows电脑（无需安装.NET 8），双击运行，确认界面资源（如图片、本地化内容）正常加载。

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