QML TextEdit.WordWrap模式为何对含前置反斜杠的单词语本异常换行？

我使用QML的TextEdit组件显示文本，其会根据宽度自动换行，wrapMode设置为TextEdit.WordWrap，该模式仅在单词边界处换行，因此单词语本不应换行。

但当文本为单个单词且以\开头时，该模式失效并自动换行。以下为简化问题代码：

import QtQuick 2.15
import QtQuick.Window 2.15

Window {
    id: root
    width: 640
    height: 480
    visible: true

    TextEdit {
        anchors.fill: parent
        wrapMode: TextEdit.WordWrap
        font.pixelSize: 20
        text: "\\non_breaking_text_for_example"
    }
}

实际运行后，文本会在第一个\字符与剩余文本之间换行；若存在多个\，则会在倒数第二个\后换行。

我曾尝试使用<p style="white-space: pre-wrap;"> + 文本 + </p>标签，却无效果；而设置为TextEdit.NoWrap时文本确实不会换行。

请问为何此场景下TextEdit.WordWrap模式失效，单词语本仍自动换行？该如何避免此问题？

原因解析 #

Qt的文本渲染引擎会将反斜杠(\)识别为类连字符的断行分隔符，在WordWrap模式下，这类字符会被判定为潜在的换行拆分点。即使是单个包含反斜杠的长单词，当文本长度接近容器宽度时，引擎会自动在反斜杠位置拆分换行，这属于Qt文本断字算法的默认行为。

解决方法 #

方法1：插入零宽非断空格阻止拆分 #

在反斜杠后插入零宽非断空格（Unicode字符\u2060），让文本引擎认为反斜杠与后续字符属于不可拆分的整体：

TextEdit {
    anchors.fill: parent
    wrapMode: TextEdit.WordWrap
    font.pixelSize: 20
    text: "\\\u2060non_breaking_text_for_example"
}

方法2：批量替换反斜杠 #

如果有大量包含反斜杠的文本，可通过JS函数批量替换反斜杠为带零宽非断空格的格式：

TextEdit {
    anchors.fill: parent
    wrapMode: TextEdit.WordWrap
    font.pixelSize: 20
    text: (function(rawText) {
        return rawText.replace(/\\/g, "\\\u2060");
    })("\\non_breaking_text_for_example")
}

方法3：禁用自动断字（Qt 5.15+） #

Qt 5.15及以上版本可尝试设置hyphenationPolicy禁用自动断字，该属性主要针对连字符断字，对反斜杠这类分隔符可作为补充尝试：

TextEdit {
    anchors.fill: parent
    wrapMode: TextEdit.WordWrap
    font.pixelSize: 20
    hyphenationPolicy: TextEdit.NoHyphenation
    text: "\\non_breaking_text_for_example"
}

方法4：强制不换行（仅适用于无需自动换行场景） #

如果不需要任何自动换行，直接设置wrapMode为TextEdit.NoWrap，需结合横向滚动条避免文本溢出：

TextEdit {
    anchors.fill: parent
    wrapMode: TextEdit.NoWrap
    font.pixelSize: 20
    horizontalScrollBarPolicy: Qt.ScrollBarAsNeeded
    text: "\\non_breaking_text_for_example"
}

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