10.7 阶段 6:工程质量、性能与可观测性
本页目录
一、阶段定位
前面五个阶段把应用做出来了:窗口、数据库、系统集成、跨端桥接。但"做出来"不等于"能上线"。本阶段解决工程质量:核心逻辑有单元测试、崩溃能被收集并带上下文、启动时间与内存有基线、性能问题能用 Profiler 定位。桌面应用是常驻进程,用户开着一天,内存只涨不降就会被关掉;启动慢 3 秒,用户第一次打开就流失。
与前后阶段的衔接:往上承接阶段 2 的分层——MVVM 让 ViewModel 可脱离 UI 测试,这正是本阶段单元测试的基础。往下接阶段 7 的打包分发——崩溃收集与日志要在打包前接好,否则线上出问题无从排查。不掌握"基线测量"思维,就会陷入"我感觉有点慢"的主观优化。
原有的三条卡点展开成可判断的现象依据:
- 所有逻辑跑在主线程,界面卡顿后找不到原因:现象是列表滚动时掉帧、点按钮后界面要等 1 秒才响应,但你不知道是数据库慢、网络慢还是渲染慢。判断依据:你没用 Profiler 看过调用栈,或者把耗时操作全塞在事件回调里。
- 只看功能可用,不记录启动时间与内存基线:现象是新版本出来后内存涨了 50MB,但你不知道是哪次改动引入的,因为没有基线数据。判断依据:你没有在日志里记录"启动完成时间",也没有对比过版本间的内存曲线。
- 崩溃信息只报堆栈,不带环境与版本上下文:现象是用户报"崩溃了",你只有一行堆栈,不知道用户版本、操作系统、操作路径,线上无法复现。判断依据:崩溃上报里没有
appVersion、OSVersion、lastAction字段。
二、阶段目标与投入
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
| 核心服务层有单元测试,覆盖业务规则与边界 | 测试通过率 > 80%,测试不引用 UI |
| 崩溃可被收集并带上下文日志 | 手动抛异常,上报包含版本、OS、堆栈 |
| 能用 Profiler 定位一次真实卡顿或内存增长 | 能说出热点函数名与耗时占比 |
| 启动时间、常驻内存、包体积有可记录的基线 | 三个数字写在文档里,每次发版对比 |
| 耗时操作放后台线程,主线程不阻塞 | 滚动列表时主线程 UI 线程响应时间 < 16ms |
| 日志不记录敏感数据 | 代码里搜不到密码、令牌字段 |
建议学时:
- 全职(每天 4–6 小时):2 周,约 50 小时。
- 在职(每天 2 小时、周末补 4 小时):5–6 周,约 55 小时。
学时分配建议:单元测试 20%、崩溃收集与日志 20%、Profiler 与性能剖析 25%、启动优化 15%、内存泄漏排查 15%、包体积裁剪 5%。
三、先修自检
| 先修项 | 合格标准 | 不合格时回到 |
|---|---|---|
| MVVM 分层 | ViewModel 不引用 UI,可脱离测试 | 10.3 阶段 2 |
| 异步与线程 | 能写 async/await 把耗时操作放后台 |
10.1 阶段 0 |
| 配置持久化 | 能读写配置文件 | 10.3 阶段 2 |
| 依赖注入 | 能写接口注入 | 10.3 阶段 2 |
经验判断:有 Web 后端经验的人容易把服务端的"APM/监控"思维直接搬过来,但桌面应用是单机进程,崩溃上报要自己实现或接第三方 SDK,没有中心化的日志收集。
四、知识地图
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 单元测试 | xUnit/NUnit、Mock 依赖、覆盖业务规则 | 会用 | 08.4 CI/CD 与可观测性 |
| UI 自动化 | 录制回放、断言控件状态 | 了解 | 08.4 CI/CD 与可观测性 |
| 崩溃收集 | 未捕获异常、上下文、上报通道 | 会用 | 08.4 CI/CD 与可观测性 |
| 日志 | 分级、轮转、不记敏感数据 | 会用 | 08.4 CI/CD 与可观测性 |
| Profiler | CPU 采样、内存快照、调用树 | 能讲清原理 | 01.1 操作系统 |
| 启动优化 | 延迟加载、预热、单实例守护 | 会用 | 08 云原生与 DevOps |
| 内存泄漏 | 常驻基线、对象生命周期、对比快照 | 能讲清原理 | 01.1 操作系统 |
| 包体积裁剪 | 资源裁剪、架构选择、未用模块剔除 | 了解 | 08 云原生与 DevOps |
进度管理建议:本阶段以 .NET / Electron 工具链为例,其他平台用对应 Profiler(Instruments、perf、DevTools)。学完每个模块在笔记里把掌握程度往下调一档;全部到位再进 阶段 7 打包分发。
五、分模块精讲
5.1 单元测试与可测试性
为什么需要它:业务规则("不能加空待办""删除后索引更新")如果靠手点界面验证,每次改代码都要全量回归。单元测试让规则变成自动化断言,且测试不依赖 UI,跑得快。
核心机制:
- 可测试性前提:ViewModel 不引用 UI 控件,外部依赖(存储、网络)通过接口注入。
- 测试框架:xUnit(.NET)、Jest/Vitest(Electron)、pytest(Python)。
- 测试分层:
- 业务规则测试:ViewModel 状态变化、命令行为。
- 边界测试:空集合、null、超长字符串。
- 异常测试:存储失败时 ViewModel 的错误处理。
- Mock:用
Moq/jest.mock模拟外部依赖,不连真实数据库。
最小可运行示例(xUnit 测试 ViewModel):
public class TodoViewModelTests
{
[Fact]
public void AddCommand_EmptyTitle_ShowsError()
{
var storage = new Mock<ITodoStorage>();
var vm = new TodoViewModel(storage.Object);
vm.Title = "";
vm.AddCommand.Execute(null);
Assert.True(vm.HasError);
Assert.Equal("标题不能为空", vm.ErrorMessage);
}
[Fact]
public void AddCommand_ValidTitle_Persists()
{
var storage = new Mock<ITodoStorage>();
var vm = new TodoViewModel(storage.Object);
vm.Title = "写测试";
vm.AddCommand.Execute(null);
storage.Verify(s => s.AddAsync("写测试"), Times.Once);
Assert.Empty(vm.ErrorMessage);
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 测试要几秒才跑完 | 测试连真实数据库 | Mock 接口,用内存 Fake |
| 测试互相影响 | 共享静态状态 | 每个测试 new 新实例 |
| 测试覆盖了 UI 而不是规则 | ViewModel 直接 new Window | 测试只 new ViewModel |
面试考法:常问"哪些逻辑不该进 ViewModel"。要答到"纯视图相关(动画、布局、控件状态)不进;业务规则、状态管理、服务调用进 ViewModel;外部服务走接口注入"。
5.2 崩溃收集与上下文日志
为什么需要它:桌面应用线上崩溃,用户只说"闪退了",你拿不到堆栈就无法修。崩溃收集要在应用启动时就挂好未捕获异常处理器,并带上版本、OS、最后操作。
核心机制:
- 未捕获异常:.NET
AppDomain.CurrentDomain.UnhandledException+Application.DispatcherUnhandledException;Electronprocess.on('uncaughtException')。 - 上下文字段:上报时带
appVersion、osVersion、arch、lastAction(最后一个用户操作)、timestamp、stackTrace。 - 上报通道:POST 到自建服务或第三方 SDK(Sentry、Bugsnag);本地先写日志文件,网络好时再上传。
- 本地诊断包:崩溃时把最近日志、配置(脱敏后)打包到临时目录,用户可手动上传。
最小可运行示例(.NET 崩溃捕获):
// App.xaml.cs OnStartup
AppDomain.CurrentDomain.UnhandledException += (s, e) =>
{
var ex = (Exception)e.ExceptionObject;
var report = new
{
appVersion = typeof(App).Assembly.GetName().Version?.ToString(),
osVersion = Environment.OSVersion.ToString(),
arch = Environment.Is64BitOperatingSystem ? "x64" : "x86",
timestamp = DateTime.UtcNow,
lastAction = LastActionTracker.Current, // 全局记录最后操作
stack = ex.ToString(),
};
// 写本地日志
File.WriteAllText(
Path.Combine(AppPaths.LogDir, $"crash-{DateTime.UtcNow:yyyyMMdd-HHmmss}.log"),
JsonSerializer.Serialize(report, new { WriteIndented = true }));
// 异步上报(不阻塞退出)
_ = ReportToServerAsync(report);
};
// 全局记录最后操作:在关键命令执行时调用
public static class LastActionTracker
{
public static string Current { get; set; } = "启动完成";
}
// ViewModel 命令里:
LastActionTracker.Current = $"添加待办:{Title}";
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 崩溃了但没上报 | 上报是同步的,崩溃时网络卡住 | 先写本地日志,异步重试上传 |
| 上报里没版本号 | 没取程序集版本 | 启动时记录并写入上下文 |
| 日志里有密码 | 日志打了整个请求对象 | 脱敏:密码字段打码 |
| 崩溃后用户看不到提示 | 只上报没通知 | 弹"已崩溃,是否上传日志" |
面试考法:常问"崩溃上报要带哪些上下文"。要答到"版本、OS、架构、最后操作、堆栈、时间;本地先落盘再异步上传;敏感数据脱敏"。
5.3 日志分级与轮转
为什么需要它:没有日志,线上问题只能猜。日志太多会撑爆磁盘,要分级(Debug/Info/Warn/Error)并轮转。
核心机制:
- 分级:Debug(开发调试)、Info(关键节点)、Warn(可疑但不影响)、Error(出错)。
- 输出:开发时写控制台;生产时写文件,按日期轮转(每天一个文件,保留 7 天)。
- 不记录:密码、令牌、完整文件内容、用户隐私字段。
- 库:.NET
Microsoft.Extensions.Logging+ Serilog;Electronelectron-log。
最小可运行示例(Serilog 配置):
Log.Logger = new LoggerConfiguration()
.MinimumLevel.Debug()
.WriteTo.File(
Path.Combine(AppPaths.LogDir, "app-.log"),
rollingInterval: RollingInterval.Day,
retainedFileCountLimit: 7)
.CreateLogger();
Log.Information("应用启动,版本 {Version}", version);
Log.Warning("存储延迟 {Ms}ms", ms);
Log.Error(ex, "添加待办失败");
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 日志文件撑爆磁盘 | 没设轮转与保留天数 | retainedFileCountLimit: 7 |
| 日志里有密码 | 打了整个对象 | 脱敏字段 |
| 生产日志太多 | Debug 级也写 | 生产设 MinimumLevel.Information |
面试考法:常问"日志为什么要分级"。要答到"Debug 只在开发看,生产 Info 以上;避免日志量过大影响性能与磁盘;分级便于快速定位问题级别"。
5.4 Profiler 定位 CPU 与卡顿
为什么需要它:界面卡顿时,"感觉慢"不够,要看调用栈:是数据库慢、还是循环太多、还是渲染重。Profiler 采样告诉你函数耗时占比。
核心机制:
- CPU 采样:Profiler 定期采样调用栈,统计每个函数占比;热点函数是耗时大头。
- 主线程 vs 后台线程:UI 卡顿看主线程(UI 线程)采样;后台慢操作看工作线程。
- 工具:.NET
dotnet-trace/ Visual Studio Diagnostic Tools;Electron Chrome DevTools Performance 面板;macOS Instruments Time Profiler。 - 渲染卡顿:列表滚动掉帧,看是否每帧有大对象创建、同步布局。
最小可运行示例(在代码里埋点计时):
var sw = Stopwatch.StartNew();
await _storage.LoadTodosAsync();
sw.Stop();
Log.Information("加载待办耗时 {Ms}ms", sw.ElapsedMilliseconds);
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 加载 1 万条待办要 3 秒 | 每条单独查询 | 一次批量查询 + UI 虚拟化 |
| 列表滚动掉帧 | 项模板太复杂 | 简化模板,用 VirtualizingStackPanel |
Profiler 显示 String.Format 占 30% |
日志格式化太频繁 | 降低日志级别 |
面试考法:常问"怎么定位界面卡顿"。要答到"用 Profiler 看主线程采样;区分主线程阻塞与后台慢操作;热点函数优化;UI 虚拟化"。
5.5 启动优化与内存泄漏
为什么需要它:桌面应用启动慢 3 秒用户会流失;常驻应用内存只涨不降,开一天就被系统杀。
核心机制:
- 启动阶段:进程启动 → 加载主窗口 → 初始化服务 → 加载数据。优化点:
- 延迟加载:非首屏数据(设置、历史)延后到用到时再加载。
- 预热:常用资源(字体、主题)提前加载,但不阻塞首屏。
- 单实例守护:第二实例快速退出。
- 内存泄漏:
- 泄漏表现:常驻内存基线随运行时间单调上升,GC 后不回落。
- 常见原因:事件订阅不退(长生命周期对象订阅短生命周期对象)、静态集合只加不减、未释放的 GDI/句柄。
- 排查:对比两个时刻的内存快照,找只增不减的对象。
最小可运行示例(延迟加载设置页):
// 启动时只初始化首屏
public MainWindow()
{
InitializeComponent();
// 首屏:待办列表
_ = LoadTodoListAsync();
}
// 设置页第一次打开时才加载
private void OpenSettings_Click(object sender, RoutedEventArgs e)
{
if (_settingsWindow == null)
{
_settingsWindow = new SettingsWindow(); // 延迟创建
}
_settingsWindow.Show();
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 启动 5 秒 | 启动时加载了所有模块 | 非首屏延迟加载 |
| 内存涨 100MB 不回落 | 事件订阅不退 | 短生命周期对象退订事件 |
| GDI 句柄泄漏 | 没释放画笔/画刷 | using 释放 GDI 对象 |
面试考法:常问"桌面应用内存持续增长怎么排查"。要答到"记录基线;对比两个时刻快照找只增不减对象;检查事件订阅、静态集合、未释放句柄"。
5.6 包体积裁剪
为什么需要它:Electron 包 100MB+,Tauri 几 MB。包越大下载越慢,更新越频繁。
核心机制:
- Electron:默认带整个 Chromium;裁剪:禁用不必要模块、压缩
asar、用electron-builder的nsis目标。 - Tauri:系统 WebView 不打包;Rust 编译 release strip 符号。
- 资源:图片压缩、不打包未用语言、字体子集化。
- 测量:每次发版记录包体积,与上一版对比。
最小可运行示例(electron-builder 配置):
{
"build": {
"appId": "com.example.notes",
"win": { "target": "nsis" },
"files": ["dist/**/*", "main.js", "preload.js"],
"asar": true
}
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 包体积 200MB | 没排除 dev 依赖 | files 白名单只包含产物 |
| 带了未用语言包 | 打包了所有语言 | 只留需要的语言 |
| 图片未压缩 | 直接打包 PNG | 压缩或转 WebP |
面试考法:常问"Electron 包体积为什么大"。要答到"打包整个 Chromium;裁剪靠白名单、asar、压缩、资源优化;Tauri 用系统 WebView 所以小"。
六、分层练习
6.1 复现型(照着做,目标是跑通 + 能解释)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 单元测试核心规则 | 给 ViewModel 写 5 条业务规则测试 | 测试通过,不引用 UI | 3 小时 |
| 崩溃捕获 | 挂未捕获异常处理器,手动抛异常 | 生成崩溃日志含版本与 OS | 2 小时 |
| 日志配置 | Serilog 按天轮转,保留 7 天 | 日志文件按天生成,旧的自动删 | 2 小时 |
| Profiler 定位卡顿 | 加载 1 万条待办,用 Profiler 找热点 | 说出热点函数名与耗时 | 2 小时 |
| 启动基线 | 记录启动时间到日志 | 日志里有"启动完成耗时 Xms" | 1 小时 |
6.2 改造型(给出现成代码,改出正确行为)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 同步改异步 | 给定回调里同步加载列表,改异步 | 启动不卡,窗口可拖 | 1.5 小时 |
| 修内存泄漏 | 给定事件订阅不退,加退订 | 内存基线稳定 | 2 小时 |
| 日志脱敏 | 给定日志打了密码,改成打码 | 日志里密码是 *** |
1 小时 |
| 延迟加载设置页 | 给定启动时创建设置窗口,改延迟 | 启动时间减少 | 1 小时 |
| 包体积裁剪 | 给定 electron-builder 没白名单,加 files |
包体积减少 30% | 1.5 小时 |
6.3 设计型(自己定方案,目标是能交付、能讲清取舍)
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 完整崩溃上报链路 | 崩溃捕获 + 本地日志 + 异步上报 + 用户提示 | 手动抛异常,服务端收到带上下文报告 | 6 小时 |
| 性能基线文档 | 记录启动时间、常驻内存、包体积基线 | 三个数字写文档,发版对比 | 4 小时 |
| 列表虚拟化 | 1 万条待办用 VirtualizingStackPanel |
滚动不卡,内存稳定 | 4 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
| 列表滚动掉帧 | 项模板复杂或未虚拟化 | Profiler 看渲染耗时 | 用虚拟化,简化模板 |
| 启动 5 秒 | 启动加载所有模块 | 看启动日志各阶段耗时 | 非首屏延迟加载 |
| 内存涨 100MB 不回落 | 事件订阅不退/句柄泄漏 | 对比内存快照 | 退订事件,释放句柄 |
| 崩溃没上报 | 上报同步阻塞 | 看崩溃时网络 | 先写本地再异步上传 |
| 日志撑爆磁盘 | 没轮转 | 看日志目录文件数 | 按天轮转保留 7 天 |
| 日志里有密码 | 打了整个对象 | 搜日志代码 | 脱敏字段 |
| 测试要几秒 | 连真实数据库 | 看测试是否 new 真实存储 | Mock 接口 |
| 包体积 200MB | 没白名单 | 看 electron-builder files |
加白名单只含产物 |
八、出口条件
全部勾选后再进入 阶段 7:打包、签名、分发与自动更新。
- [ ] 核心服务层有单元测试,测试不引用 UI
- [ ] 崩溃可被收集并带版本、OS、最后操作上下文
- [ ] 能用 Profiler 定位一次真实卡顿并说出热点函数
- [ ] 启动时间、常驻内存、包体积有可记录的基线
- [ ] 耗时操作放后台线程,主线程不阻塞
- [ ] 日志不记录敏感数据,按天轮转
- [ ] 排障表里随机抽三个现象,能在 5 分钟内给出排查路径
自测题(先自己想,再看要点):
- 崩溃上报要带哪些上下文?
- 要点:版本、OS、架构、最后操作、堆栈、时间;本地先落盘再异步上传;敏感数据脱敏。
- 为什么测试不能连真实数据库?
- 要点:慢、不稳定、数据污染;用接口 Mock,测试快且隔离。
- 界面卡顿怎么定位?
- 要点:Profiler 看主线程采样;找热点函数;区分主线程阻塞与后台慢操作。
- 桌面应用内存持续增长怎么排查?
- 要点:记录基线;对比两个时刻快照找只增不减对象;检查事件订阅、静态集合、句柄。
- 启动优化的手段有哪些?
- 要点:非首屏延迟加载;预热不阻塞首屏;单实例守护。
- 日志为什么要分级与轮转?
- 要点:Debug 只在开发;生产 Info 以上;按天轮转保留 7 天避免撑爆磁盘。
- Electron 包体积为什么大?怎么裁剪?
- 要点:打包整个 Chromium;白名单、asar、资源优化、只留需要语言。