如何在QTextEdit中实现项目符号列表与普通文本的互相切换

问题根源 #

你当前的实现只是修改了已有列表的缩进属性，没有真正将目标段落从列表中移除。只要段落还属于列表对象，cursor.currentList()就会一直返回非空值，永远走不到新建列表的分支，自然无法二次切换为项目符号。

正确实现方案 #

要清除列表属性，直接给目标段落设置普通的文本块格式即可，不需要操作现有列表的格式。兼容单行、多行选中切换的实现代码如下：

def bullet_list(self):
    cursor = self.textEdit.textCursor()
    # 先判断当前光标所在/选中的段落是否属于列表
    current_list = cursor.currentList()
    
    if current_list:
        # 转为普通文本：给选中的所有段落设置普通块格式，脱离列表
        # 保存选中范围，避免操作过程中选区丢失
        start = cursor.selectionStart()
        end = cursor.selectionEnd()
        
        # 遍历选中的所有段落
        cursor.setPosition(start)
        while cursor.position() <= end:
            # 设置普通块格式，自动解除列表关联
            cursor.setBlockFormat(QTextBlockFormat())
            # 移动到下一个段落
            cursor.movePosition(QTextCursor.NextBlock)
        
        # 恢复原来的选区
        cursor.setPosition(start)
        cursor.setPosition(end, QTextCursor.KeepAnchor)
    else:
        # 转为项目符号列表
        list_format = QTextListFormat()
        list_format.setStyle(QTextListFormat.Style.ListDisc)
        cursor.createList(list_format)
    
    # 统一设置光标和焦点，不用重复写
    self.textEdit.setTextCursor(cursor)
    self.textEdit.setFocus()

补充说明 #

• 该实现支持选中多行批量切换列表/普通文本状态
• 调用setBlockFormat传入空的QTextBlockFormat时，Qt会自动将当前段落从所属列表中移除，彻底清除列表属性，后续currentList()会正确返回空值，就可以再次触发新建列表的逻辑
• 不需要手动操作列表的缩进、样式等属性，直接通过块格式调整更符合Qt的富文本模型设计
• 注意提前导入QTextBlockFormat类，PyQt5/PyQt6/PySide系列均在对应的QtGui模块下

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