如何解决WPF TextBox设置文本时的性能卡顿问题？

原因分析 #

WPF TextBox设置文本时出现卡顿，与WinForms的差异核心源于两者底层设计和文本处理机制的不同：

1. 图形渲染模式差异：WPF采用保留模式图形系统，每次修改Text属性会触发完整的布局测量（Measure）、排列（Arrange）流程，同时执行文本格式化、字体渲染等相对重量级操作；而WinForms是立即模式，文本更新直接基于GDI+绘制，底层逻辑更轻量化。
2. Dispatcher调度冗余：测试代码中在MouseMove事件（本身已运行在UI线程）内调用Application.Current.Dispatcher.Invoke，会将文本更新操作排入Dispatcher队列末尾，额外增加调度延迟，加剧卡顿。
3. 默认功能额外开销：WPF TextBox默认开启拼写检查、文本自适应布局等功能，频繁更新文本时会累积性能开销；WinForms TextBox默认无此类额外处理逻辑。

测试验证 #

WPF测试场景 #

仅对设置WPF TextBox文本的耗时计时，超1毫秒则输出：

• 单台设备随机出现2-11毫秒延迟，部分设备甚至达200毫秒
• 控件首次实例化的7-8毫秒延迟仅出现一次，需关注鼠标移动时持续出现的卡顿

XAML代码

<Window x:Class="TextBoxTest.MainWindow"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  xmlns:local="clr-namespace:TextBoxTest"
  Width="800" Height="800"
  mc:Ignorable="d">
    <Grid x:Name="MainGrid">
        <TextBox x:Name="tb"/>
    </Grid>
</Window>

后台代码

public MainWindow()
{
    InitializeComponent();
    
    this.MouseMove += UpdateTextBox;
}

private void UpdateTextBox(object sender, MouseEventArgs e)
{
    var rnd = MainWindow.r.Next(20);

    Application.Current.Dispatcher.Invoke(() => 
    {
        _time.Restart();
        tb.Text = rnd + "";
        _time.Stop();
        if (_time.ElapsedMilliseconds > 0)
        {
            Debug.WriteLine(_time.ElapsedMilliseconds + "ms");
        }
    });
}

输出结果

'TextBoxTest.exe' (CoreCLR: clrhost): Loaded 'C:\Program Files\dotnet\shared\Microsoft.NETCore.App\6.0.10\System.Diagnostics.StackTrace.dll'. 
7ms
3ms
3ms
4ms
3ms
...

WinForms测试场景 #

替换WPF TextBox为WinForms TextBox（通过WindowsFormsHost嵌入），其余代码一致，测试无任何超1毫秒的卡顿。

XAML代码

<Window x:Class="TextBoxTest.MainWindow"
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
  xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
  xmlns:wf="clr-namespace:System.Windows.Forms;assembly=System.Windows.Forms"
  xmlns:local="clr-namespace:TextBoxTest"
  Width="800" Height="800"
  mc:Ignorable="d">
    <Grid x:Name="MainGrid">
        <WindowsFormsHost Height="40" Width="80">
            <wf:TextBox x:Name="tb" />
        </WindowsFormsHost>
    </Grid>
</Window>

输出结果

'TextBoxTest.exe' (CoreCLR: clrhost): Loaded 'C:\Program Files\dotnet\shared\Microsoft.NETCore.App\6.0.10\System.Diagnostics.StackTrace.dll'.

解决方法 #

1. 移除冗余的Dispatcher调用 #

MouseMove事件本身运行在UI线程，无需额外调用Dispatcher.Invoke，直接执行文本更新逻辑：

private void UpdateTextBox(object sender, MouseEventArgs e)
{
    var rnd = MainWindow.r.Next(20);
    _time.Restart();
    tb.Text = rnd.ToString();
    _time.Stop();
    if (_time.ElapsedMilliseconds > 1)
    {
        Debug.WriteLine(_time.ElapsedMilliseconds + "ms");
    }
}

2. 禁用不必要的TextBox功能 #

关闭拼写检查、输入法支持等默认功能，减少文本处理开销：

<TextBox x:Name="tb" 
         SpellCheck.IsEnabled="False"
         InputMethod.IsInputMethodEnabled="False"/>

3. 对高频事件进行防抖处理 #

MouseMove触发频率极高，通过防抖限制文本更新频率，避免频繁触发布局渲染：

private DateTime _lastUpdateTime = DateTime.MinValue;
private const int ThresholdMs = 10;

private void UpdateTextBox(object sender, MouseEventArgs e)
{
    var now = DateTime.Now;
    if ((now - _lastUpdateTime).TotalMilliseconds < ThresholdMs)
        return;
    
    _lastUpdateTime = now;
    var rnd = MainWindow.r.Next(20);
    tb.Text = rnd.ToString();
}

4. 使用轻量文本控件替代 #

若无需编辑功能，可使用TextBlock或Label替代TextBox，这类控件的文本更新开销远低于TextBox：

<TextBlock x:Name="tb"/>

5. 手动控制布局更新 #

若必须使用TextBox，可手动暂停布局更新，完成文本修改后再恢复，减少布局触发次数：

private void UpdateTextBox(object sender, MouseEventArgs e)
{
    var rnd = MainWindow.r.Next(20);
    // 暂停布局更新
    tb.Dispatcher.Invoke(() =>
    {
        tb.Measure(new Size(double.PositiveInfinity, double.PositiveInfinity));
        tb.Arrange(new Rect(tb.DesiredSize));
        tb.UpdateLayout();
    }, DispatcherPriority.Background);
    
    _time.Restart();
    tb.Text = rnd.ToString();
    _time.Stop();
    
    // 恢复布局更新
    tb.UpdateLayout();
}

内容的提问来源于stack exchange，提问作者P Weiss