Day 5 - 配置版本、备份与升级

建议用时：150-210 分钟

你将学会什么

现场配置和程序版本必须匹配。升级前备份，升级后迁移，失败时能回滚。今天的 3 个例子都要亲手敲，不能只复制，也不能只看运行结果。

标为 Program.cs 的最小例子可以放进控制台练习项目；标为 Service、ViewModel、XAML 或 SQL 文件的例子，要在本周项目中按前一天已经建立的模型继续敲。文件名和上下文不同，不要把所有片段塞进同一个 Program.cs。

这是 Week 21 的第 5 天。先使用前面已经掌握的 C#、异步、异常、接口和 MVVM，只增加今天这一层上位机能力。

现场配置和程序版本必须匹配。升级前备份，升级后迁移，失败时能回滚。

学习时固定按这个顺序：


先看数据是什么
-> 再看最小代码
-> 对照运行结果
-> 修改一个参数
-> 故意制造错误
-> 最后组合进上位机项目

文件：Program.cs


public class AppConfig
{
    public int SchemaVersion { get; set; } = 3;
    public List<DeviceConfig> Devices { get; set; } = [];
}

运行结果或界面效果：


配置文件明确结构版本

必须改一次： 启动时拒绝未知更高版本。

文件：Program.cs


string temp = configPath + ".tmp";
await File.WriteAllTextAsync(temp, json, token);
File.Move(temp, configPath, overwrite: true);

运行结果或界面效果：


先完整写临时文件，再替换正式文件

必须改一次： 替换前保存 .bak。

文件：upgrade-plan.txt


停止采集 -> 备份程序/配置/数据库 -> 安装新版本
-> 迁移配置和数据库 -> 自动测试 -> 启动采集
-> 失败则停止并恢复备份

运行结果或界面效果：


升级和回滚步骤成对出现

必须改一次： 在测试机完整演练一次。

修错顺序固定为：先看第一条异常和行号，再看输入数据，再看原始字节或状态，最后才怀疑框架。

答案不能只背一句话。回到三个例子，用代码中的变量、方法和输出逐项说明。能脱离页面说清楚，才算真的理解。