.NET Core 3 WPF启用<PublishSingleFile>编译成功但无法运行

我之前碰到过一模一样的情况，你的问题核心在于单文件发布时，标记为“复制到输出目录”的配置文件（比如appsettings.json）会被直接嵌入到EXE文件中，而不是输出到发布目录，但你的代码仍然在尝试从当前文件系统目录读取这些文件，导致程序因找不到依赖文件静默崩溃——WPF默认不会主动弹出异常提示，这就是你看不到报错的原因。

下面是具体的解决步骤：

1. 先确认异常根源 #

因为WPF在未处理异常时可能直接退出，建议先通过两种方式排查错误：

• 添加全局异常捕获：在App.xaml.cs中加入以下代码，让未处理的异常弹窗显示：

protected override void OnStartup(StartupEventArgs e)
{
    AppDomain.CurrentDomain.UnhandledException += (sender, args) =>
    {
        MessageBox.Show($"程序异常：{args.ExceptionObject}", "错误", MessageBoxButton.OK, MessageBoxImage.Error);
        Environment.Exit(1);
    };
    base.OnStartup(e);
}

• 或者临时把项目改成控制台应用，这样运行时异常会直接输出到控制台，方便快速定位问题。

2. 修改配置文件读取逻辑 #

既然文件被嵌入到了单EXE中，就需要通过程序集读取嵌入式资源，而非直接从文件系统读取。假设你的appsettings.json在项目根目录，项目命名空间为WpfSingleFileDemo，修改读取代码如下：

using System.Reflection;
using System.IO;
using System.Text;
using Microsoft.Extensions.Configuration;

// 获取当前程序集实例
var assembly = Assembly.GetExecutingAssembly();
// 资源名称格式：[项目命名空间].[文件名]，如果文件在子目录，要加上子目录路径（比如Resources.appsettings.json）
var resourceName = "WpfSingleFileDemo.appsettings.json";

// 读取嵌入式资源流
using (var stream = assembly.GetManifestResourceStream(resourceName))
{
    if (stream == null)
    {
        MessageBox.Show($"找不到嵌入式资源：{resourceName}", "错误", MessageBoxButton.OK, MessageBoxImage.Error);
        return;
    }
    
    using (var reader = new StreamReader(stream))
    {
        var jsonContent = reader.ReadToEnd();
        // 构建配置对象
        var configuration = new ConfigurationBuilder()
            .AddJsonStream(new MemoryStream(Encoding.UTF8.GetBytes(jsonContent)))
            .Build();
        
        // 后续正常使用configuration读取配置项即可，比如 configuration["AppSettings:YourKey"]
    }
}

3. 确保资源被正确嵌入 #

检查你的.csproj文件，确保配置文件的属性设置正确，单文件发布时默认会将Content类型的文件嵌入，如果你需要明确配置，可以添加：

<ItemGroup>
  <Content Update="appsettings.json">
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
    <EmbeddedResource>true</EmbeddedResource>
  </Content>
</ItemGroup>

同时确认你的发布配置没有问题：

• 目标框架：netcoreapp3.0
• 部署模式：自包含
• 目标运行时：win-x64
• 已开启单文件发布（对应.csproj中的<PublishSingleFile>true</PublishSingleFile>）

这样修改后，你的单文件WPF应用就能正确读取嵌入的配置文件，正常启动运行了。

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