如何自定义WPF应用.NET Runtime缺失时的初始化错误提示

目前.NET 6及以上版本已经原生支持自定义启动初始化错误提示，不需要像老.NET Framework版本那样修改宿主资源，以下是三种可直接落地的方案：

• 方案1：原生配置自定义提示（零代码，优先推荐）
  直接在WPF项目的csproj文件中添加如下属性组配置，即可替换默认的模糊提示，明确告知用户所需运行时信息：

  <PropertyGroup>
    <!-- 自定义错误弹窗标题 -->
    <AppHostWindowsErrorDialogTitle>程序启动失败</AppHostWindowsErrorDialogTitle>
    <!-- 自定义错误提示正文，明确标注所需组件 -->
    <AppHostWindowsErrorDialogMessage>本程序运行需要安装 .NET 6 Desktop Runtime，请安装对应组件后重新启动。</AppHostWindowsErrorDialogMessage>
    <!-- 可选：配置弹窗中下载按钮的跳转地址，可指向你自行准备的运行时安装包地址 -->
    <AppHostWindowsErrorDialogUrl></AppHostWindowsErrorDialogUrl>
  </PropertyGroup>
  

  配置完成后重新发布项目即可生效，当目标设备未安装对应运行时时，弹窗会优先显示你自定义的内容，不会再出现用户看不懂的模糊提示。

• 方案2：自包含发布，从根源消除运行时依赖
  如果不希望用户手动安装任何组件，可以将项目发布为自包含模式，发布时会将.NET 6 Desktop Runtime和程序打包在一起，用户拿到后可直接运行，完全不会触发运行时缺失的错误。对应csproj配置如下：

  <PropertyGroup>
    <OutputType>WinExe</OutputType>
    <TargetFramework>net6.0-windows10.0.19041.0</TargetFramework>
    <UseWPF>true</UseWPF>
    <!-- 开启自包含发布 -->
    <SelfContained>true</SelfContained>
    <!-- 可选：开启单文件打包+程序集裁剪，大幅缩小发布包体积 -->
    <PublishSingleFile>true</PublishSingleFile>
    <PublishTrimmed>true</PublishTrimmed>
    <IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>
  </PropertyGroup>
  

  注意使用裁剪模式时需要测试WPF程序的兼容性，避免反射相关的逻辑被裁剪导致运行异常。

• 方案3：原生引导器（完全自定义交互场景使用）
  如果需要完全自定义提示窗口的样式、交互逻辑（比如自动静默安装运行时、显示图文引导步骤），可以额外开发一个无依赖的Win32原生小程序作为启动器：启动器先检测当前设备是否已安装对应版本的.NET 6 Desktop Runtime，未安装则弹出你完全自定义的提示窗口，检测通过后再启动主WPF程序。该方案兼容性最强，不受.NET SDK版本变动影响，但需要额外维护一个小型启动程序。

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