Qt技术问题：如何保存含自定义属性的QTextEdit内容

我完全懂你碰到的这个痛点——QTextEdit默认导出HTML的时候，根本不会管我们加的自定义字符属性，毕竟标准HTML里没地方放这些“私货”嘛。不过别担心，有两种靠谱的方法能解决这个问题，我给你详细拆解下：

方法一：手动构建HTML，把自定义属性嵌入span标签 #

既然默认的toHtml()不支持自定义属性，那我们就自己遍历文档内容，手动生成HTML，把你的音频位置数据作为HTML5的data-*自定义属性嵌入到<span>标签里，完全符合HTML规范。

示例代码（导出） #

def custom_to_html(editor):
    doc = editor.document()
    html_content = ['<html><body>']
    
    # 遍历文档的每一个文本块
    current_block = doc.firstBlock()
    while current_block.isValid():
        block_length = current_block.length() - 1  # 减去块末尾的结束符
        pos_in_block = 0
        
        while pos_in_block < block_length:
            # 创建光标选中当前字符
            cursor = QTextCursor(current_block)
            cursor.setPosition(current_block.position() + pos_in_block)
            cursor.movePosition(QTextCursor.NextCharacter, QTextCursor.KeepAnchor)
            
            char_format = cursor.charFormat()
            # 检查当前字符是否带有自定义属性
            if char_format.hasProperty(MyPropertyID):
                audio_pos = char_format.property(MyPropertyID)
                # 把两个整数转成用逗号分隔的字符串
                data_attr_val = f"{audio_pos[0]},{audio_pos[1]}"
                # 生成带自定义属性的span标签
                html_content.append(f'<span data-audio-pos="{data_attr_val}">{cursor.selectedText()}</span>')
            else:
                # 没有自定义属性，直接追加文本
                html_content.append(cursor.selectedText())
            
            pos_in_block += 1
        
        html_content.append('<br>')
        current_block = current_block.next()
    
    html_content.append('</body></html>')
    return ''.join(html_content)

导入恢复属性 #

当你需要从自定义HTML加载时，先调用editor.setHtml()加载基础内容，然后遍历文档里的所有<span>元素，提取data-audio-pos属性，再把它设置回对应的字符格式即可。

方法二：分离保存HTML和自定义数据 #

如果不想手动构建HTML，也可以把基础HTML和自定义属性数据分开保存——比如把HTML作为主体，把自定义数据序列化成JSON，嵌入到HTML的注释里，或者单独存成一个文件。这种方法更灵活，适合复杂的自定义数据。

示例代码（保存） #

import json

def save_editor_with_custom_data(editor, save_path):
    # 先保存基础HTML内容
    base_html = editor.toHtml()
    
    # 提取所有带自定义属性的字符数据
    doc = editor.document()
    custom_properties = []
    current_block = doc.firstBlock()
    
    while current_block.isValid():
        block_length = current_block.length() - 1
        pos_in_block = 0
        
        while pos_in_block < block_length:
            cursor = QTextCursor(current_block)
            cursor.setPosition(current_block.position() + pos_in_block)
            cursor.movePosition(QTextCursor.NextCharacter, QTextCursor.KeepAnchor)
            
            char_format = cursor.charFormat()
            if char_format.hasProperty(MyPropertyID):
                # 记录字符的全局位置、长度和音频属性
                custom_properties.append({
                    'start_pos': cursor.selectionStart(),
                    'char_length': cursor.selectionEnd() - cursor.selectionStart(),
                    'audio_pos': list(char_format.property(MyPropertyID))
                })
            
            pos_in_block += 1
        
        current_block = current_block.next()
    
    # 把JSON数据嵌入到HTML注释里，一起保存
    with open(save_path, 'w', encoding='utf-8') as f:
        f.write(base_html)
        f.write('\n<!-- CUSTOM_PROPERTIES_START -->\n')
        f.write(json.dumps(custom_properties, indent=2))
        f.write('\n<!-- CUSTOM_PROPERTIES_END -->\n')

示例代码（加载） #

import json

def load_editor_with_custom_data(editor, file_path):
    with open(file_path, 'r', encoding='utf-8') as f:
        full_content = f.read()
    
    # 分离基础HTML和自定义数据
    start_marker = '<!-- CUSTOM_PROPERTIES_START -->'
    end_marker = '<!-- CUSTOM_PROPERTIES_END -->'
    
    if start_marker in full_content and end_marker in full_content:
        base_html, rest_content = full_content.split(start_marker, 1)
        custom_data_str, _ = rest_content.split(end_marker, 1)
        custom_properties = json.loads(custom_data_str.strip())
        
        # 先加载基础HTML
        editor.setHtml(base_html)
        
        # 恢复自定义属性
        doc = editor.document()
        for prop in custom_properties:
            cursor = QTextCursor(doc)
            cursor.setPosition(prop['start_pos'])
            cursor.movePosition(QTextCursor.NextCharacter, QTextCursor.KeepAnchor, prop['char_length'])
            
            char_format = cursor.charFormat()
            char_format.setProperty(MyPropertyID, tuple(prop['audio_pos']))
            cursor.setCharFormat(char_format)
    else:
        # 没有自定义数据，直接加载HTML
        editor.setHtml(full_content)

两种方法的选择 #

• 如果希望导出的HTML尽量标准、能被其他工具识别，选方法一，自定义数据嵌入在span标签里，一目了然。
• 如果你的自定义属性更复杂，或者不想手动处理HTML构建逻辑，选方法二，分离数据更灵活，出错概率更低。

内容的提问来源于stack exchange，提问作者al.zatv