百度360必应搜狗淘宝本站头条
HTML5 标签标签HTML5 标签 (已废弃)HTML 简介键盘快捷键
当前位置：网站首页 > 技术文章 > 正文

Avalonia日志组件实现与优化指南

zhezhongyun 2025-08-02 22:46 2 浏览

背景

Avalonia 目前没有富文本框可实现日志输出显示，但提供了SelectableTextBlock控件可以替换，这是站长实现的一个日志组件效果：

可展示日志时间、日志级别、日志详细内容等，后台除输出到界面外，也可持久化输出到文本文件，对于更多的日志信息展示可自行扩展，下面先讲解实现过程，再指出存在的问题，欢迎 PR。

使用

安装：

NuGet\Install-Package CodeWF.LogViewer.Avalonia -Version 1.0.10.2

视图使用：

xmlns:log="https://codewf.com"

<log:LogView />

日志输出：

Logger.Debug("调试日志");
Logger.Info("信息日志");
Logger.Warn("警告日志");
Logger.Error("错误日志");
Logger.Fatal("致命日志");

实现

只说关键部分代码，具体代码可浏览CodeWF.LogViewer仓库。

程序通过Logger类输出日志，该类将日志信息缓存到ConcurrentQueue<LogInfo> Logs集合，Logger类定义如下：

public staticclassLogger
{
 publicstatic LogType Level = LogType.Info;
 publicstaticstring LogDir = AppDomain.CurrentDomain.BaseDirectory;
 internalstaticreadonly ConcurrentQueue<LogInfo> Logs = new();

 public static void RecordToFile()
 {
 Task.Run(async () =>
 {
 while (true)
 {
 while (TryDequeue(outvar log))
 {
 var content =
 $"{log.RecordTime}: {log.Level.Description()} {log.Description}{Environment.NewLine}";
 AddLogToFile(content);
 }

 await Task.Delay(TimeSpan.FromMilliseconds(100));
 }
 });
 }

 public static bool TryDequeue(out LogInfo info)
 {
 return Logs.TryDequeue(out info);
 }

 public static void Log(int type, string content)
 {
 var logType = (LogType)type;
 if (Level > logType) return;
 Logs.Enqueue(new LogInfo(logType, content));
 }

 public static void Debug(string content)
 {
 if (Level <= LogType.Debug)
 {
 Logs.Enqueue(new LogInfo(LogType.Debug, content));
 }
 }

 public static void Info(string content)
 {
 if (Level <= LogType.Info)
 {
 Logs.Enqueue(new LogInfo(LogType.Info, content));
 }
 }

 public static void Warn(string content)
 {
 if (Level <= LogType.Warn)
 {
 Logs.Enqueue(new LogInfo(LogType.Warn, content));
 }
 }

 public static void Error(string content, Exception? ex = )
 {
 if (Level > LogType.Error) return;

 var msg = ex ==  ? content : $"{content}\r\n{ex.ToString()}";

 Logs.Enqueue(new LogInfo(LogType.Error, msg));
 }

 public static void Fatal(string content, Exception? ex = )
 {
 if (Level > LogType.Fatal) return;

 var msg = ex ==  ? content : $"{content}\r\n{ex.ToString()}";

 Logs.Enqueue(new LogInfo(LogType.Fatal, msg));
 }

 public static void AddLogToFile(string msg)
 {
 try
 {
 var logFolder = System.IO.Path.Combine(LogDir, "Log");
 if (!Directory.Exists(logFolder))
 {
 Directory.CreateDirectory(logFolder);
 }

 var logFileName = System.IO.Path.Combine(logFolder, $"Log_{DateTime.Now:yyyy_MM_dd}.log");
 File.AppendAllText(logFileName, msg);
 }
 catch
 {
 // ignored
 }
 }
}

只输出日志到文本文件

如果只是输出日志到文本文件，而不需要输出到界面，需要主动调用Logger.RecordToFile()方法定时检查日志输出。

同时输出日志到文本文件和视图

前提：这里不需要调用Logger.RecordToFile()方法

我们先看视图LogView.axaml，该部分使用ScrollViewer包裹SelectableTextBlock，以实现日志滚动查看及日志文本的可选择复制：

<ScrollViewer
 x:Name="LogScrollViewer"
 HorizontalScrollBarVisibility="Auto"
 PointerPressed="LogScrollViewer_OnPointerPressed"
 VerticalScrollBarVisibility="Auto">
 <SelectableTextBlock
 x:Name="LogTextView"
 TextAlignment="Start"
 TextWrapping="Wrap">
 <SelectableTextBlock.ContextMenu>
 <ContextMenu x:Name="LogContextMenu">
 <MenuItem Click="Copy_OnClick" Header="复制" />
 <MenuItem Click="Clear_OnClick" Header="清空" />
 <MenuItem Click="Location_OnClick" Header="查看日志" />
 </ContextMenu>
 </SelectableTextBlock.ContextMenu>
 </SelectableTextBlock>
</ScrollViewer>

LogView.axaml.cs内调用RecordLog()方法定时读取缓存日志，并再调用LogNotifyHandler方法写入界面，及调用Logger.AddLogToFile方法写入文本文件，代码不多，下面是核心部分：

partial classLogView : UserControl
{
 // ...
 private void RecordLog()
 {
 if (_isRecording) return;

 _isRecording = true;

 Task.Run(async () =>
 {
 while (true)
 {
 while (Logger.TryDequeue(outvar log)) LogNotifyHandler(log);

 await Task.Delay(TimeSpan.FromMilliseconds(100));
 }
 });
 }

 private void LogNotifyHandler(LogInfo logInfo)
 {
 if (Logger.Level > logInfo.Level) return;

 _synchronizationContext.Post(o =>
 {
 var inlines = _textView.Inlines;
 try
 {
 if (inlines?.Count > MaxCount)
 {
 for (var i = 0; i < 3; i++)
 {
 var needRemoveElement = inlines.First();
 if (needRemoveElement != )
 {
 inlines.Remove(needRemoveElement);
 }
 }
 }

 var start = _textView.Text.Length;

 inlines?.Add(
 new Run($"{logInfo.RecordTime}")
 {
 Foreground = new SolidColorBrush(Color.Parse("#8C8C8C")),
 BaselineAlignment = BaselineAlignment.Center
 });
 inlines?.Add(GetLevelInline(logInfo.Level));
 inlines?.Add(new Run(logInfo.Description)
 {
 Foreground = new SolidColorBrush(Color.Parse("#262626")),
 BaselineAlignment = BaselineAlignment.Center
 });
 inlines?.Add(new Run(Environment.NewLine));

 Logger.AddLogToFile(
 $"{logInfo.RecordTime}: {logInfo.Level.Description()} {logInfo.Description}{Environment.NewLine}");

 _textView.SelectionStart = start;
 _textView.SelectionEnd = _textView.Text.Length;
 _scrollViewer.ScrollToEnd();
 }
 catch
 {
 // ignored
 }
 }, );
 }

 private Span GetLevelInline(LogType level)
 {
 var content = level.Description();

 // 创建宽度为零的透明文本，用于复制使用
 // TODO：复制还是有问题，会错位
 var zeroWidthText = new Run($"【{content}】")
 {
 Foreground = Brushes.Transparent, FontSize = 0.001
 };

 // 视觉显示的文本，不会被复制使用
 var border = new Border
 {
 BorderBrush = GetLevelForeground(level),
 Background = GetLevelBackground(level),
 BorderThickness = new Thickness(1),
 CornerRadius = new CornerRadius(2),
 Padding = new Thickness(8, 0),
 Margin = new Thickness(8, 2),
 VerticalAlignment = VerticalAlignment.Center,
 IsHitTestVisible = false,
 Child = new TextBlock
 {
 Text = content,
 Foreground = GetLevelForeground(level),
 IsHitTestVisible = false
 }
 };
 var levelSpan = new Span();
 levelSpan.Inlines.Add(zeroWidthText);
 levelSpan.Inlines.Add(border);
 return levelSpan;
 }
 // ...
}

上面省略了根据日志类型获取展示前景色、背景色等等代码，这不重要。

存在的问题

看上面的GetLevelInline方法，该方法生成日志级别块，使用的Border套日志级别描述(调试、错误等），实现日志类型带边框效果，但复制存在问题：

选择的7:56 调试 模块块并按Ctrl + C复制，再粘贴到记事本，复制出来是调试】模块名称A-，很明显的错位问题。

复制的应该是文本内容，但Border是不允许复制的，所以代码中留了注释创建宽度为零的透明文本，用于复制使用：

// 创建宽度为零的透明文本，用于复制使用
// TODO：复制还是有问题，会错位
var zeroWidthText = new Run($"【{content}】")
{
 Foreground = Brushes.Transparent, FontSize = 0.001
};

具体的不细说了，大家有什么解决方案吗？等待有缘人 PR 了，感谢。

总结

本文主要是寻求 PR，该组件如果对您有用，欢迎使用，仓库地址：

  • CodeWF.LogViewer：https://github.com/dotnet9/CodeWF.LogViewer

下篇分享自定义 TabItem 边框实现：


相关推荐

Excel高效技巧:批量合并重复数据的实用指南

在日常数据处理中，我们常会遇到需要合并相邻重复单元格的场景。无论是整理分类标签、统计重复项还是优化报表格式，手动逐个合并不仅耗时且容易出错。本文将详细介绍三种专业高效的批量合并方法，助您轻松应对各种复...

自主研发高速动车组列车又添新成员(新时代画卷)

数据来源：国铁集团">数据来源：国铁集团CR400AF—S型列车驶过重庆。龙帆摄（人民视觉）">CR400AF—S型列车驶过重庆。龙帆摄（人民视觉）CR400BF—GZ型列车行驶在京...

福彩双色球幻圆图的VBA程序(第一部分)

很多朋友喜欢玩福彩双色球彩票，都知道下面的这张图——福彩双色球红球幻圆图和篮球幻方图。图2是福彩双色球2024104期（红色）和2024105期（黄色）的幻圆图。图3是福彩双色球2024105期（红色...

技巧 | 往MCP服务器添加提示词模板

在我的上一篇文章[1]中，我已经构建了一个本地MCP服务器并向其添加了一些工具。在本文中，我们将向该MCP服务器添加提示词。这是如同上一篇博客的文件结构。但在这里，我为此创建了两个新文件。.├──...

Avalonia日志组件实现与优化指南

背景Avalonia目前没有富文本框可实现日志输出显示，但提供了SelectableTextBlock控件可以替换，这是站长实现的一个日志组件效果：可展示日志时间、日志级别、日志详细内容等，后台除输...

vim编辑器最后几行@代表什么意思

使用vim编辑文本时，屏幕下方会出现一些@符号，这些符号代表什么意思？当vim设置了wrap属性时，若一行太长则就会发生折行现象，此时一个逻辑行就会显示多个屏幕行，如下图由于文件的第2行太长，一个真实...

浅色AI云食堂APP完整代码(二)

以下是整合后的浅色AI云食堂APP完整代码，包含后端核心功能、前端界面以及优化增强功能。项目采用Django框架开发，支持库存管理、订单处理、财务管理等核心功能，并包含库存预警、数据导出、权限管理等增...

QML控件:TextInput, TextField, TextEdit, TextArea用法及自定义

本文主要介绍基本元素TextInput,TextField,TextEdit,TextArea等的基本属性。Textlnput与TextField为行编辑控件，TextEdit与T...

WPF - 10.特殊容器控件

摘要这里我们要介绍的特殊容器空间是ScrollViewer，该控件与其他控件不同的是，可以支持滚动显示容器内的元素。下面我们举例说明如何在WPF中使用ScrollViewer控件。新建一个WPF程...

rhino6.0 python中ETO的组件案例

1.按钮组件按钮几乎放置在每个对话框上。创建一个新的按钮很简单。使用forms.Button并指定Text显示在按钮面上。除了创建新按钮外，通常还通过.Click事件附加一个操作。使用+=语法，如下...

Rhino6.0 窗口开发使用角本说明

第1个：生成窗口代码第2点：Eto界面主要由Dialog（主程序界面）、Layout（界面布局）和Controls（控件）三个部分构成，逻辑简单且清晰。这个脚本被分为三个主要部分。该import...

手把手教你搭建属于自己的服务器!

最近总是想搭建自己的网站，奈何皮夹里空空如也，服务器也租不起，更别说域名了。于是我就寻思能否自己搭建个服务器，还不要钱呢？还真行！！！经过几天的冲浪，我发现有两个免费的建站工具：Apache和Ng...

HEAT杂志《欧美猛男》排行!“雷神”居然没进前三!

提到猛男的必备条件，应该就是要有着让人看了会流口水的大块肌肉，而一说到猛男，小编第一个想到的就是spanstyle="text-transform:none;background-color:...

Power Query 表格列历遍函数Table.TransformColumns函数

PowerQuery提取数字应该是非常方便的，EH有这样一道题：一看到这题首先想的是PowerQuery，可能中毒有点深，思路挺简单的，PowerQuery有一个从数字到非数字的分列分列后再提取...

自学前端踩了30个坑，终于整理出这份新手避坑指南

这是我在自学前端的第37天，对着一个简单的HTML页面卡了整整一下午。不是逻辑错误，不是语法问题，只是我不知道为什么，一个div死活居中不了。那时候的我，以为前端就是写写页面、调调样式，直到后来才...

一周热门
最近发表
标签列表