WPF多线程场景下高效处理日志文本展示的方案咨询

一、Dispatcher阻塞问题优化 #

直接修复方案 #

将同步调用的Dispatcher.Invoke替换为异步调用的Dispatcher.BeginInvoke，前者会阻塞工作线程直到主线程执行完毕，后者为非阻塞调用，不会影响工作线程运行。

高阶优化方案（推荐） #

使用「线程安全队列+定时批量刷入」的模式，彻底避免频繁调度主线程，性能提升最明显：

1. 定义日志缓存队列与刷新定时器：

// 全局字段
private readonly ConcurrentQueue<Paragraph> _pendingLogs = new ConcurrentQueue<Paragraph>();
private readonly DispatcherTimer _logFlushTimer;

2. 在页面构造函数中初始化定时器：

public YourPageName()
{
    InitializeComponent();
    // 每150ms批量刷新一次日志，可根据需求调整间隔
    _logFlushTimer = new DispatcherTimer(TimeSpan.FromMilliseconds(150), DispatcherPriority.Normal, (s, e) =>
    {
        if (_pendingLogs.IsEmpty) return;
        var blocks = ConsoleFlowDocument.Document.Blocks;
        // 批量写入所有待处理日志
        while (_pendingLogs.TryDequeue(out var log))
        {
            blocks.Add(log);
        }
        // 可选：保持滚动到最新日志
        ConsoleFlowDocument.ScrollToEnd();
    }, Dispatcher);
    _logFlushTimer.Start();
    // 关闭FlowDocument不必要的排版计算，进一步提升性能
    ConsoleFlowDocument.Document.IsHyphenationEnabled = false;
    ConsoleFlowDocument.Document.IsOptimalParagraphEnabled = false;
}

3. 改造日志回调逻辑，不再直接调度主线程：

case ConsoleLoggerEventType.Log:
    var log = new Paragraph(new Run(args.Message)) { FontSize = 12 };
    _pendingLogs.Enqueue(log);
    break;

二、控件选型建议 #

可直接按业务需求选择，3000行的量级下以下方案都能稳定运行：

• 若需要富文本样式（错误日志标红、警告标黄、关键词高亮等）：继续使用FlowDocumentScrollViewer即可。官方文档提到的性能劣势是针对单条简单文本的轻量场景，大文本量带格式的场景下，FlowDocument的渲染效率远高于堆叠多个TextBlock的实现，社区推荐是合理的。
• 若仅需要纯文本展示，不需要任何自定义样式：直接用只读TextBox即可，设置IsReadOnly="True"、VerticalScrollBarVisibility="Auto"，TextBox自带UI虚拟化，千行到万行级别的性能比FlowDocument更好，代码实现也更简单。
• 若后续日志量级可能超过1万行，还需要搜索、行号等额外功能：选用专门的文本展示控件即可，性能比原生控件更优。

额外优化建议 #

• 可设置日志保留上限，比如最多保留1万行，超过时自动删除最早的日志，避免内存持续上涨。
• 新增日志时可判断滚动条位置，仅当用户停留在最底部时自动滚动，避免打断用户查看历史日志的操作。

内容的提问来源于stack exchange，提问作者Ahmed Fawzy