QTextCursor插入带格式文本在段落分隔符后异常问题排查

正确插入方法 #

• 问题核心：普通空格会和后续插入的字符被合并到同一个文本片段，若空格所在片段没有你的自定义TagInfo格式，特殊字符的格式会被覆盖。而ParagraphSeparator会创建新段落，中断这种合并，所以格式能生效。
• 直接给特殊字符单独设置格式，不要依赖格式继承：

  QTextCursor cursor = ui->textEdit->textCursor();
  // 构建自定义格式
  QTextCharFormat customFormat;
  customFormat.setProperty(TagInfo::YourCustomProperty, yourTagData);
  // 先把光标格式设为自定义格式
  cursor.setCharFormat(customFormat);
  // 插入ObjectReplacementCharacter
  cursor.insertText(QString(QChar::ObjectReplacementCharacter));
  

• 如果需要保留空格，要么给空格也应用相同格式，要么把特殊字符单独拆成片段：

  QTextCursor cursor = ui->textEdit->textCursor();
  QTextCharFormat customFormat;
  customFormat.setProperty(TagInfo::YourCustomProperty, yourTagData);
  // 插入带格式的空格（可选）
  cursor.insertText(" ", customFormat);
  // 插入带格式的特殊字符
  cursor.insertText(QString(QChar::ObjectReplacementCharacter), customFormat);
  

QTextDocumentPrivate::split的格式处理逻辑 #

• split函数的核心作用是分割文本块内的文本片段，处理同段落内的插入操作时，Qt会优先合并相邻的同格式片段：
  • 插入普通空格时，空格会继承前一个文本片段的格式，后续插入的ObjectReplacementCharacter如果没有明确设置格式，会被合并到这个空格所在的片段，导致自定义格式丢失。
  • 插入ParagraphSeparator时，会强制创建一个新的QTextBlock，新段落的初始格式会继承当前光标已设置的格式，此时插入特殊字符不会被合并到之前的片段，格式自然生效。

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