一、Qt6文本框基础与竖排需求背景

在GUI开发中，文本框（QLineEdit/QTextEdit/QPlainTextEdit）是核心控件之一。Qt6作为跨平台框架，其文本渲染机制基于QTextLayout，默认采用水平从左到右的排版方式。但在特定场景下（如古籍排版、日文竖排显示、艺术效果设计），需要将文字改为垂直方向排列。

Qt6本身未直接提供”vertical text”属性，但通过组合样式表、自定义绘制或文本布局控制可实现该效果。本文将深入探讨三种主流实现方案，并对比其适用场景与性能表现。

二、方法一：使用样式表实现简单竖排

2.1 基础样式设置

from PyQt6.QtWidgets import QApplication, QTextEdit
app = QApplication([])
text_edit = QTextEdit()
text_edit.setStyleSheet("""
    QTextEdit {
        writing-mode: vertical-rl;  /* 从右向左垂直排列 */
        text-orientation: mixed;   /* 保持字符原始方向 */
        direction: rtl;            /* 配合writing-mode使用 */
    }
""")
text_edit.setPlainText("竖排文字示例\n第二行")
text_edit.resize(200, 300)
text_edit.show()
app.exec()

关键点解析：

• writing-mode: vertical-rl 是核心属性，表示垂直从右到左排列
• text-orientation: mixed 保持汉字直立，拉丁字母旋转90度
• 需配合direction: rtl确保布局方向正确

2.2 样式表局限性

1. 浏览器兼容性问题：该属性源自CSS Writing Modes Module，Qt6通过WebKit引擎模拟实现，但不同平台渲染效果可能有差异
2. 控件限制：仅QTextEdit/QLabel等支持富文本的控件有效，QLineEdit无效
3. 复杂布局失控：当混合中英文时，自动换行可能不符合预期

三、方法二：自定义绘制实现精确控制

3.1 重写paintEvent方法

from PyQt6.QtWidgets import QWidget, QApplication
from PyQt6.QtGui import QPainter, QFontMetrics
from PyQt6.QtCore import Qt
class VerticalTextWidget(QWidget):
    def __init__(self, text, parent=None):
        super().__init__(parent)
        self.text = text
        self.char_width = 20  # 每个字符的显示宽度
    def paintEvent(self, event):
        painter = QPainter(self)
        painter.setPen(self.palette().color(self.foregroundRole()))
        fm = QFontMetrics(self.font())
        # 从下往上逐字符绘制
        for i, char in enumerate(self.text):
            y = self.height() - (i + 1) * self.char_width
            painter.drawText(10, y, char)
    def sizeHint(self):
        return QSize(50, len(self.text) * 20)
# 使用示例
app = QApplication([])
widget = VerticalTextWidget("自定义竖排")
widget.resize(100, 200)
widget.show()
app.exec()

实现要点：

• 手动计算每个字符的Y坐标（从底部向上排列）
• 通过char_width控制字符间距
• 重写sizeHint()提供合理默认尺寸

3.2 性能优化策略

1. 缓存字符位置：对静态文本预先计算坐标
2. 双缓冲技术：在复杂场景下使用QPixmap缓存绘制结果
3. 增量更新：仅重绘变化部分区域

四、方法三：QTextDocument高级排版

4.1 创建垂直布局的文档

from PyQt6.QtWidgets import QApplication, QTextEdit
from PyQt6.QtGui import QTextCursor, QTextBlockFormat, QTextCharFormat
from PyQt6.QtCore import Qt
class VerticalTextEdit(QTextEdit):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.setVerticalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAlwaysOff)
        self.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAlwaysOff)
    def setVerticalText(self, text):
        self.clear()
        cursor = self.textCursor()
        # 设置垂直方向的块格式
        block_format = QTextBlockFormat()
        block_format.setLayoutDirection(Qt.LayoutDirection.RightToLeft)
        # 逐字符插入（模拟竖排）
        for char in reversed(text):  # 从下往上排列
            char_format = QTextCharFormat()
            cursor.insertText(char, char_format)
            cursor.movePosition(QTextCursor.MoveOperation.NextBlock)
# 使用示例
app = QApplication([])
edit = VerticalTextEdit()
edit.setVerticalText("文档模型竖排")
edit.resize(80, 300)
edit.show()
app.exec()

4.2 混合排版解决方案

对于中英文混合场景，建议：

1. 按语义分割文本（如句子/词语为单位）
2. 对中文使用垂直排列，英文保持水平旋转90度
3. 通过QTextFrame实现复杂布局

五、性能对比与选型建议

方案	渲染速度	灵活性	适用场景
样式表实现	快	低	简单静态文本
自定义绘制	中	高	复杂动态效果
QTextDocument	慢	极高	富文本混合排版

推荐选型：

• 古籍展示类应用：方法三（精确控制）
• 实时数据监控：方法二（高性能）
• 简单标签显示：方法一（开发快捷）

六、常见问题解决方案

6.1 中英文混合排版问题

# 使用正则表达式分割中英文
import re
def split_text(text):
    pattern = re.compile(r'([\u4e00-\u9fa5]+)|([a-zA-Z0-9]+)')
    return pattern.findall(text)
# 处理结果如：[('中文', ''), ('', 'English'), ('数字123', '')]

6.2 跨平台字体适配

from PyQt6.QtGui import QFontDatabase
def load_cross_platform_font():
    font_id = QFontDatabase.addApplicationFont(":/fonts/simsun.ttc")
    if font_id == -1:
        # 回退到系统字体
        return QFont("Microsoft YaHei", 12)
    families = QFontDatabase.applicationFontFamilies(font_id)
    return QFont(families[0], 12)

七、最佳实践建议

1. 预处理文本：对长文本进行分块处理，避免单次绘制过多内容
2. 异步加载：对超长文本使用QThread分批加载
3. 样式隔离：通过QSS类选择器避免影响其他控件
4. 测试验证：在Windows/macOS/Linux下分别测试渲染效果

通过上述方法，开发者可以灵活实现Qt6中的文字竖排需求。实际项目中，建议根据具体场景选择最适合的方案，复杂项目可考虑组合使用多种技术。