WPF RichTextBox输入每个新字符均自动换行问题排查

核心触发原因 #

• 控件属性被异常修改：AcceptsReturn属性被全局/局部样式误设为True，同时存在输入事件拦截逻辑异常，导致每次输入都会触发回车换行逻辑。
• FlowDocument 段落样式损坏：如果当前作用域内存在针对Paragraph类型的无Key隐式样式，给段落设置了异常的固定宽度、超大边距、错误行高，会导致单个字符就占满行宽触发自动换行。
• 文档结构残留：如果RichTextBox之前加载过包含多块级元素（Section、List、Table等）的FlowDocument，没有清空残留块结构，每次输入文本都会自动生成新的Paragraph块，表现为单字占一行。
• 输入事件逻辑错误：如果为RichTextBox挂载了PreviewTextInput或TextChanged事件，事件处理逻辑中每次输入都调用Document.Blocks.Add()新增段落，而非往当前光标所在的文本流追加内容，就会出现逐字符换行。

快速排查步骤 #

• 先给出问题的RichTextBox显式声明以下属性，排除样式赋值干扰：

  <RichTextBox 
      AcceptsReturn="False" 
      AcceptsTab="False"
      TextWrapping="Wrap"
      TextAlignment="Left"/>
  

  运行后如果输入恢复正常，说明问题来自上层继承的样式，逐次排查窗口、全局资源字典里针对RichTextBox的样式即可。
• 临时注释掉当前作用域内所有针对Paragraph类型的隐式样式，测试输入是否正常。如果恢复，检查对应样式里是否设置了不合理的Width、Margin、Padding、LineHeight属性，尤其注意是否误设了固定宽度导致单字触发换行。
• 在控件初始化逻辑里加入以下代码重置文档结构，排除残留块元素干扰：

  yourRichTextBox.Document.Blocks.Clear();
  yourRichTextBox.Document.Blocks.Add(new Paragraph(new Run()));
  

• 临时移除RichTextBoxHelper.DocumentXaml的绑定做对照测试——即使你是在问题出现后才加的绑定，也要排除绑定默认值、同步逻辑异常导致的文档结构损坏。
• 检查所有和RichTextBox输入相关的事件处理代码，确认没有在输入回调里手动插入新段落块。

注意：如果你的系统开了高DPI缩放但应用没有声明DPI感知，极少数情况下也会因为RichTextBox的排版计算异常出现单字换行，这种情况在app.manifest里开启Per-Monitor DPI感知即可修复。

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