.NET Core 3.1单文件构建后不同版本生成多配置文件夹求助

核心原因 #

单文件发布时，.NET Core会为生成的可执行文件计算哈希值，并将该哈希作为配置文件夹的一部分，版本升级后哈希变化导致生成新的配置目录，无法读取旧配置。而非单文件发布时，配置目录基于程序集版本和名称，因此能正常迁移配置。

解决方案 #

1. 自定义配置存储路径 #

放弃默认的Settings.Default存储机制，手动指定固定的配置文件路径，比如程序专属的应用数据目录或程序所在目录的自定义文件：

// 示例：使用应用数据目录存储配置，避免权限问题
private static readonly string ConfigDir = Path.Combine(
    Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
    "YourAppName"
);
private static readonly string ConfigPath = Path.Combine(ConfigDir, "appsettings.user.json");

// 读取配置
public static T LoadConfig<T>() where T : new()
{
    Directory.CreateDirectory(ConfigDir);
    if (File.Exists(ConfigPath))
    {
        var json = File.ReadAllText(ConfigPath);
        return JsonSerializer.Deserialize<T>(json, new JsonSerializerOptions { PropertyNameCaseInsensitive = true });
    }
    return new T();
}

// 保存配置
public static void SaveConfig<T>(T config)
{
    Directory.CreateDirectory(ConfigDir);
    var json = JsonSerializer.Serialize(config, new JsonSerializerOptions { WriteIndented = true });
    File.WriteAllText(ConfigPath, json);
}

使用时直接调用上述方法替代默认Settings.Default，版本升级后配置文件路径固定，不会丢失配置。

2. 手动迁移旧配置 #

若坚持使用默认Settings.Default，可在程序启动时主动查找旧版本配置文件，将内容迁移至新目录：

// 获取当前配置文件所在目录
var currentConfigDir = Path.GetDirectoryName(Settings.Default.FilePath);
// 获取默认配置的根目录（应用数据下的程序专属目录）
var appConfigRoot = Path.GetDirectoryName(Path.GetDirectoryName(currentConfigDir));

// 遍历所有旧版本配置目录，匹配程序名称前缀
foreach (var dir in Directory.GetDirectories(appConfigRoot, "YourAppName.*"))
{
    if (dir == currentConfigDir) continue;
    var oldConfigFile = Path.Combine(dir, "user.config");
    if (File.Exists(oldConfigFile))
    {
        // 加载旧配置并复制到当前配置
        var oldSettings = new Settings();
        oldSettings.Load();
        
        // 逐个复制配置项（根据你的实际配置项调整）
        Settings.Default.Theme = oldSettings.Theme;
        Settings.Default.WindowSize = oldSettings.WindowSize;
        Settings.Default.LastLogin = oldSettings.LastLogin;
        
        Settings.Default.Save();
        break; // 找到最近的旧版本后停止遍历
    }
}

注意替换YourAppName为你的程序集名称，确保配置项名称在版本升级中未变更。

3. 尝试禁用单文件哈希目录（.NET Core 3.1有限支持） #

在项目文件（.csproj）中添加以下配置，尝试让单文件发布使用程序集版本而非哈希作为目录标识：

<PropertyGroup>
    <PublishSingleFile>true</PublishSingleFile>
    <UseAppHost>true</UseAppHost>
    <DisableAssemblyVersionHash>true</DisableAssemblyVersionHash>
</PropertyGroup>

该属性在.NET Core 3.1中存在兼容性限制，需测试验证是否生效。

注意事项 #

• 自定义配置路径时，优先选择Environment.SpecialFolder.ApplicationData目录，避免程序安装在系统盘时出现写入权限问题。
• 迁移旧配置时，需处理配置项新增/删除的情况，可通过空值判断或默认值赋值避免异常。

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