1. 为什么我选了 Avalonia 而不是 WPF 来做这块工业面板先说结论这个项目我最后是用Avalonia C# NModbus落地的跑在 Windows 和 Linux 两种工控机上现场连续运行了三个月没重启过。但中间踩的坑比我预想的多得多尤其是 Modbus TCP 这块看着协议简单真到工业现场全是细节。工业设备监控面板这个需求说白了就是把车间里一堆 PLC、仪表、传感器的实时数据抓上来在屏幕上画成仪表盘、趋势图、报警灯让值班的人一眼能看出哪台设备不对劲。传统做法是 WinForm 或者 WPFWindows 上跑得好好的但这两年越来越多客户要求上位机跑在 Linux 工控机或者国产化环境上WPF 直接出局。Avalonia 是跨平台的XAML 语法跟 WPF 很像迁移成本低这是我选它的第一个理由。第二个理由是渲染。Avalonia 用的是 Skia 渲染引擎画曲线、画仪表盘这种自绘控件性能比 WPF 的矢量渲染在某些场景下更可控。我实测过一块 1920x1080 的面板同时刷新 8 路趋势曲线、每路 200 个点Avalonia 在 Linux 上帧率稳定在 50 以上这个数据对我来说够用了。第三个理由比较现实Avalonia 的控件库生态虽然不如 WPF 成熟但够用。像 Avalonia.Controls.DataGrid、LiveChartsCore、ScottPlot 这些画工业图表完全没问题。我一开始还担心控件不够后来发现真正需要的是自己写几个专用控件比如状态灯、指针表盘这些用 Canvas 加 Path 手撸反而更灵活。不过我得先泼盆冷水Avalonia 不是 WPF 的平替它有自己的脾气。比如它的线程模型、绑定机制、样式系统跟 WPF 有细微但致命的差别。我第一个坑就栽在跨线程更新 UI 上后面会细说。提示如果你的项目只在 Windows 上跑且团队 WPF 经验丰富没必要为了跨平台硬上 Avalonia。但如果客户明确要求 Linux 或国产化Avalonia 是目前 C# 生态里最靠谱的选择。2. Modbus TCP 在工业现场的真实脾气2.1 协议本身很简单复杂的是现场Modbus TCP 的报文结构稍微查一下就知道MBAP 头7 字节 PDU。功能码常用的就那几个0x03 读保持寄存器、0x04 读输入寄存器、0x01 读线圈、0x05 写单线圈、0x06 写单寄存器、0x10 写多寄存器。用 NModbus 库几行代码就能读到一个寄存器的值。但现场不是实验室。我遇到的第一个问题是设备地址和寄存器地址的偏移。很多 PLC 手册上写的寄存器地址是 40001、40002 这种这是 Modbus 的逻辑地址实际发送时要从 40001 减去 40001 得到 0也就是偏移量。但有些设备厂商不按套路来手册写 40001实际要发 1。这个坑我踩了两次第一次是西门子 S7-200 Smart第二次是某国产温控仪表两次偏移规则还不一样。第二个问题是字节序。Modbus 寄存器是 16 位的但工业现场很多数据是 32 位浮点数占两个寄存器。这两个寄存器谁在前谁在后以及每个寄存器内部两个字节谁在前组合起来有四种情况ABCD、CDAB、BADC、DCBA。我遇到过一个流量计手册上写大端模式结果实际是 CDAB调了半天才发现。第三个问题是超时和重试。工业现场的网络环境比办公室恶劣得多交换机、光纤收发器、无线网桥任何一环抖动都会导致超时。NModbus 默认的超时是 1000ms重试 3 次这个参数在实验室够用在现场经常误报。我后来把超时改成 300ms重试 2 次同时在应用层做数据缓存读失败时用上一次的有效值避免面板上数据跳变。2.2 轮询策略决定了面板的流畅度监控面板要实时但实时不等于疯狂轮询。我一开始写了个死循环每 50ms 把所有设备的寄存器读一遍结果现场 20 台设备每台读 10 个寄存器一轮下来要 200 个请求网络直接堵死PLC 的通信口都开始丢包。后来改成分组轮询 优先级队列。把设备按重要性分成三组关键设备报警相关200ms 轮询一次普通设备 1s 一次辅助设备 5s 一次。每组用一个独立的 Task 跑互不干扰。同时限制并发请求数最多同时发 4 个请求避免把 PLC 的通信缓冲区打满。这个策略调整之后网络负载降了 80%面板刷新反而更流畅了。因为关键数据更新快操作工感知不到延迟非关键数据慢一点也没人在意。2.3 断线重连不是简单的 try-catchModbus TCP 是基于 TCP 的TCP 本身有重连机制但工业现场的情况是网线被叉车压断、交换机断电、PLC 重启这些都会导致连接断开。NModbus 的 TcpClient 在连接断开后不会自动重连你得自己处理。我一开始的做法是 catch 到异常就重新 new 一个 TcpClient结果发现有时候 PLC 还没启动完重连太频繁反而被 PLC 拉黑有些 PLC 有连接数限制。后来改成指数退避重连第一次断开后等 1s 重连失败等 2s再失败等 4s最多等 30s。同时加了一个心跳检测每 10s 发一个读请求连续 3 次失败才判定为断线。这里有个细节TcpClient 的 Close 和 Dispose 要小心。如果直接 Close底层的 Socket 可能不会立即释放导致端口被占用。我后来统一用using包裹或者显式调用Dispose并且在重连前先Thread.Sleep(100)给系统一点时间回收资源。3. Avalonia 跨线程更新 UI 的坑我踩了三次3.1 第一次直接在后台线程改 ObservableCollectionModbus 轮询是在后台 Task 里跑的读到数据后我想直接更新绑定到 UI 的 ObservableCollection。结果 Avalonia 直接抛异常Call from invalid thread。这个跟 WPF 一样UI 元素只能在 UI 线程访问。WPF 里用Dispatcher.InvokeAvalonia 里也有Dispatcher.UIThread.InvokeAsync。我改成这样await Dispatcher.UIThread.InvokeAsync(() { Devices[i].Value newValue; });但这样有个问题每个数据点都 Invoke 一次频繁调用会导致 UI 线程消息队列堆积。我实测过20 台设备、每台 10 个数据点、200ms 刷新一次一秒钟要 Invoke 1000 次UI 直接卡成幻灯片。3.2 第二次批量更新 定时刷新后来我改成数据层和 UI 层分离。后台线程只负责把数据写到一个 ConcurrentDictionary 里UI 层用一个 DispatcherTimer每 100ms 从字典里取一次数据批量更新到界面上。这样 Invoke 的次数从 1000 次/秒降到 10 次/秒UI 流畅多了。但这里又有个坑DispatcherTimer 的优先级。Avalonia 的 DispatcherTimer 默认优先级是 Normal如果 UI 线程正在处理其他消息Timer 回调会被延迟。我后来把优先级调到DispatcherPriority.Render保证在渲染前更新数据视觉效果更跟手。3.3 第三次绑定通知的属性名写错了这个坑最隐蔽。我用INotifyPropertyChanged实现数据模型属性名是Value但通知的时候写成了value小写。Avalonia 的绑定是大小写敏感的结果界面上数据永远不刷新但调试的时候看后台数据又是对的。我查了两个小时才发现是大小写问题。后来我养成了一个习惯用nameof代替字符串。public double Value { get _value; set { if (Math.Abs(_value - value) 0.001) { _value value; OnPropertyChanged(nameof(Value)); } } }另外加了个死区判断浮点数变化小于 0.001 就不通知避免微小波动导致界面频繁重绘。注意Avalonia 的绑定默认是 OneWay如果要双向绑定必须显式写ModeTwoWay。我一开始忘了写导致界面上改的值传不回 ViewModel。4. 面板控件选型与自绘哪些用现成的哪些必须手撸4.1 现成控件能覆盖 70% 的需求工业监控面板常见的元素数值显示、状态灯、开关按钮、趋势曲线、报警列表。这些 Avalonia 都有现成的或者成熟的第三方库。数值显示用TextBlock加绑定就行但要注意格式化。工业数据经常要保留小数位、加单位、超限变色。我写了一个ValueConverter根据配置的上下限自动切换前景色超过上限红色低于下限蓝色正常绿色。状态灯用Ellipse加Fill绑定简单直接。但要注意闪烁效果。报警时状态灯要闪烁我用Animation做了一个透明度循环但发现动画在数据刷新时会重置。后来改成用DispatcherTimer手动切换Opacity虽然土但稳定。趋势曲线我试过三个库LiveChartsCore、ScottPlot、OxyPlot。最后选了ScottPlot原因是它的性能最好10 万点数据秒级渲染而且 API 简单适合工业场景。LiveChartsCore 的动画很漂亮但工业面板不需要花哨的动画稳定压倒一切。4.2 指针表盘必须自己画工业现场很多操作工习惯看指针表比如压力表、温度表。这种控件没有现成的得自己用CanvasPath画。我的做法是定义一个GaugeControl继承Control重写Render方法。用DrawingContext画圆弧、刻度线、指针。指针的角度根据当前值和量程计算double angle startAngle (value - minValue) / (maxValue - minValue) * (endAngle - startAngle);这里有个细节Avalonia 的坐标原点是左上角角度是顺时针。画圆弧的时候要算好起始角度和扫过角度不然表盘会画反。我一开始没注意画出来的表盘指针是逆时针转的被现场操作工吐槽这表坏了。另外自绘控件的刷新频率要控制。如果每次数据变化都触发InvalidateVisualCPU 占用会很高。我加了一个MinRefreshInterval默认 50ms低于这个间隔的变化直接忽略。4.3 报警列表用 DataGrid 还是 ListBox报警列表要显示时间、设备名、报警内容、等级还要支持排序和筛选。我一开始用DataGrid功能全但性能差1000 条报警滚动就卡。后来换成ListBoxDataTemplate自己实现排序和筛选性能好很多。但ListBox默认不支持列宽自适应我用Grid在DataTemplate里手动分列列宽用*比例分配。这样虽然不如 DataGrid 灵活但胜在轻量。提示Avalonia 的DataGrid在 Linux 上有时候会有渲染问题尤其是滚动条样式。如果项目要跨平台建议优先考虑ListBox或ItemsRepeater。5. 现场部署时那些文档不会告诉你的事5.1 Linux 工控机上的字体问题Avalonia 在 Linux 上默认用的字体是系统的 Sans 字体但很多国产 Linux 发行版比如统信 UOS、麒麟默认没有安装完整的字体包导致界面上的中文显示成方块。解决办法有两个一是在项目里嵌入字体文件用FontFamily指定资源路径二是在部署脚本里安装字体包。我选的是第一种把思源黑体嵌入到程序集里虽然增加了 10MB 体积但保证了在任何 Linux 上都能正常显示。FontFamily x:KeyAppFontavares://MyApp/Assets/Fonts/#Source Han Sans/FontFamily注意字体文件的路径和字体名称要对应#后面是字体的 Family Name不是文件名。5.2 触摸屏上的点击区域工业现场很多面板用的是触摸屏操作工戴着手套点。Avalonia 默认的按钮点击区域是控件本身的大小如果按钮太小戴手套根本点不中。我的做法是所有可点击控件的实际点击区域比视觉区域大一圈。用Padding或者在外面套一个透明的Border把HitTestVisible设为 true。另外按钮的最小尺寸设为 60x60这是戴手套操作的经验值。还有一个坑触摸屏的双击和长按。Avalonia 的Button默认只响应单击如果需要长按得自己用PointerPressed和PointerReleased加计时器实现。我写了一个LongPressBehavior按住 800ms 触发长按事件用于一些危险操作的二次确认。5.3 程序崩溃后的自动重启工业现场没人会去手动重启程序所以程序必须能自己爬起来。我在 Linux 上用systemd配置了服务挂了自动重启。Windows 上用Task Scheduler或者写一个守护进程。但自动重启有个问题如果程序启动时就崩溃会陷入无限重启循环。我加了一个启动计数器如果 5 分钟内重启超过 3 次就写日志并停止重启等人来排查。另外日志一定要写文件。工业现场没有调试器出了问题只能看日志。我用Serilog写滚动日志每天一个文件保留 30 天。日志里记录 Modbus 请求的耗时、失败原因、重连次数这些数据对排查现场问题非常有用。6. 三个月运行下来我总结的几条硬经验第一条Modbus 轮询一定要做数据缓存和死区判断。现场网络抖动是常态如果每次读失败就把界面数据清零操作工会以为设备停了。正确的做法是保留上一次的有效值同时用一个数据陈旧标志在界面上提示。死区判断则是避免浮点数微小波动导致界面频繁刷新。第二条Avalonia 的 UI 更新一定要批量、定时。不要在每个数据点变化时都 Invoke而是攒一批用 DispatcherTimer 统一刷新。刷新频率 100ms 左右是人眼感觉流畅的阈值再快就是浪费 CPU。第三条自绘控件要控制刷新频率并且做好抗锯齿。工业面板上的曲线和表盘如果边缘有锯齿看起来很不专业。Avalonia 的RenderOptions可以设置抗锯齿模式我一般用Antialias加HighQuality。第四条部署前一定要在目标环境上跑至少 72 小时。我在开发机上跑了一周没问题部署到现场第二天就发现内存缓慢增长。后来查出来是 Modbus 的 TcpClient 没有正确释放每次重连都泄漏一点。改成using之后内存稳定在 200MB 左右跑三个月没涨过。第五条给现场运维留一个诊断模式。我在面板上藏了一个隐藏按钮长按 5 秒进入诊断模式可以看到每个设备的连接状态、最后一次通信时间、累计失败次数。这个功能在排查现场问题时省了我大量时间不用远程连上去看日志。最后说个小事Avalonia 的vlc相关扩展我试过想用来做报警声音播放但在 Linux 上依赖太多最后放弃了改用NAudio在 Windows 上播Linux 上用System.Diagnostics.Process调用aplay。工业现场对声音的要求不高能响就行没必要为了跨平台引入一个庞大的多媒体库。
