Day 5 - 串口缓冲区、异步读取与取消

建议用时：150-210 分钟

你将学会什么

从 BaseStream 异步读取
累积缓冲区并解析帧
用 CancellationToken 停止接收循环

DataReceived 只表示有数据到达，不保证一帧完整；正确做法是读入缓冲区再解析。今天的 3 个例子都要亲手敲，不能只复制，也不能只看运行结果。

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

学习衔接

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

今天的最低通过线

顺序	必须掌握	怎么证明
1	从 BaseStream 异步读取	能用自己的话解释并完成对应例子
2	累积缓冲区并解析帧	能用自己的话解释并完成对应例子
3	用 CancellationToken 停止接收循环	能用自己的话解释并完成对应例子

先用大白话理解

DataReceived 只表示有数据到达，不保证一帧完整；正确做法是读入缓冲区再解析。

学习时固定按这个顺序：


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

例子 1：异步读取一批字节

文件：Program.cs


byte[] buffer = new byte[256];
int count = await port.BaseStream.ReadAsync(buffer, cancellationToken);
byte[] received = buffer[..count];
Console.WriteLine(Convert.ToHexString(received));

运行结果或界面效果：


显示本次实际收到的字节

必须改一次： 打印 count，不要输出整个 256 字节数组。

例子 2：把分段数据放进缓存

文件：Program.cs


var cache = new List<byte>();
cache.AddRange([0xAA, 0x03, 0x10]);
cache.AddRange([0x20, 0x30]);
Console.WriteLine(cache.Count);

运行结果或界面效果：

必须改一次： 当缓存达到完整帧长度后删除已处理字节。

例子 3：取消接收循环

文件：Program.cs


using var cts = new CancellationTokenSource(TimeSpan.FromSeconds(2));
try
{
    while (true)
    {
        await Task.Delay(500, cts.Token);
        Console.WriteLine("等待串口数据");
    }
}
catch (OperationCanceledException)
{
    Console.WriteLine("接收已停止");
}

运行结果或界面效果：


等待若干次后显示接收已停止

必须改一次： 把超时改成 5 秒。

常见错误和修法

在 DataReceived 中直接更新 Avalonia 控件
忽略 ReadAsync 返回的实际 count
停止窗口时没有取消读取任务

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

小白重复敲写训练

不看上面的代码，重新敲“异步读取一批字节”。
不看上面的代码，重新敲“把分段数据放进缓存”。
不看上面的代码，重新敲“取消接收循环”。
完成改动任务：打印 count，不要输出整个 256 字节数组。
完成改动任务：当缓存达到完整帧长度后删除已处理字节。
完成改动任务：把超时改成 5 秒。

每日小测

今天的知识在上位机里解决什么问题？
三个例子分别输入了什么，输出了什么？
如果运行结果不对，你第一步检查什么？
哪一段代码负责停止、超时或错误处理？

小测答案

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

今日作业

新建空项目，不复制地重做三个例子。
每个例子都完成“必须改一次”。
故意制造一个错误，记录错误文字和修复办法。
把今天代码提交到自己的练习仓库。

作业验收

三个例子都能运行或显示预期界面。
能解释关键数据从哪里来、经过什么处理、最后去哪里。
失败时不会让程序无提示崩溃。
能说出今天内容如何进入“Avalonia 串口调试助手”。