在 PySide6 里QTextEdit 的 setHtml 经常出现一种很迷惑的现场文字能出来但标题层级、颜色、列表、表格边框、图片全丢最后看起来和 setPlainText 差不多。问题通常不在 setHtml 这一行而在 QTextDocument 支持的 HTML/CSS 子集、Resources/HTML001.html 的编码与资源路径以及你有没有一个能把这些问题逐项对照出来的通道。TaoToken 官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 它提供 Key 和 API Base URL让 Codex 接入后帮你只读分析 HTML 文件、路径和编码TaoToken 只供 Key 和 Base URL不代替 setHtml 渲染最终显示仍然由 QTextEdit/QTextDocument 决定。本文按排障视角写先在官网创建 Key把 Codex 的 config.toml 指向 https://taotoken.net/api再用 Codex 对照 QTextDocument 支持范围、HTML001.html 的编码和 Resources 路径最后回到 QTextEdit 里做最小验证。一、QTextEdit 的 setHtml 为什么只显示文字不显示格式先明确一个前提QTextEdit 不是浏览器。它底层用 QTextDocument 解析 HTML但 QTextDocument 只实现了 HTML 的一个子集CSS 也是子集。你在 CSDN、Notepad 或浏览器里看着正常的 HTML001.html直接塞进 setHtml 后可能只剩段落文本。常见丢失点主要有四类。第一类是标签超出支持范围。script、iframe、canvas、video、audio、svg 复杂结构、表单控件等通常不会按浏览器方式渲染。QTextDocument 更擅长的是 h1-h6、p、span、strong、em、u、a、ul、ol、li、table、tr、td、blockquote、pre、code、img 这类基础标签。第二类是 CSS 超出支持范围。display:flex、grid、position:absolute、transform、媒体查询、伪类、CSS 变量、复杂选择器、外部样式表在 QTextDocument 里大概率被忽略。相比之下行内 style 比 class/id 选择器更可靠但也不是所有属性都生效。比如 color、font-weight、font-style、text-decoration、background-color、text-align 相对常用复杂盒模型、浮动、动画不要期待。第三类是资源路径问题。你的原文里是 open 读 Resources/HTML001.html再 setHtml。HTML 里的 img src 如果还是网络 URL、相对路径、反斜杠路径、中文路径或者基于工作目录而不是基于 HTML001.html 所在目录图片就可能不显示。QTextDocument 不会自动帮你把所有相对资源都解析成正确本地文件尤其是打包后工作目录变化时Resources 路径很容易失效。第四类是编码与 BOM。文件保存成 UTF-8 with BOM 时open(..., encodingutf8) 可能让 HTML 开头多出不可见字符QTextDocument 解析时可能把第一个标签前的内容当文本处理导致开头样式异常。中文 HTML 更推荐用 utf-8-sig 读或者保存成无 BOM UTF-8。所以不要把问题简化成“setHtml 坏了”。更准确的说法是HTML001.html 里有些内容不在 QTextDocument 支持范围内或者路径和编码让解析结果和你预期不一致。Codex 适合做的是帮你把这些不一致逐项列出来而不是替你运行 QTextEdit。二、TaoToken 前置先创建 Key再给 Codex 配 Base URL排障之前先把通道配好。打开 TaoToken 官网进入控制台创建 API Key。官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建 Key 的页面建议直接走 API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keys拿到 Key 后不要把它写进文章、截图或提交到仓库。本文用 YOUR_API_KEY 代替。接下来配置 Codex。Codex 的 Base URL 只填https://taotoken.net/api注意两点不要写成 https://taotoken.net/api/v1也不要在这个 API 地址后面加 UTM 参数。Codex 的 config.toml 负责模型提供方和模型 IDTaoToken 负责 Key 和 Base URL 通道。配好之后Codex 可以读取你本地的 Resources/HTML001.html、Python 文件和项目目录输出对照分析。它不会替 QTextEdit 渲染也不能保证它建议的每个 HTML 标签都被 QTextDocument 支持。如果你还没配过 Codex建议先看接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc这篇的重点是排障所以 Key 创建和 Base URL 只是前置真正要花时间的是后面 QTextDocument 的对照。三、Codex 的 config.toml 可复制配置Base URL 只写 https://taotoken.net/apiCodex 常用配置文件是 ~/.codex/config.toml。Windows 下通常在 C:\Users\你的用户名.codex\config.toml。下面是一份可复制模板把 MODEL_ID 换成你在 TaoToken 控制台看到的可用模型 ID把 YOUR_API_KEY 换成自己的 Key。# ~/.codex/config.toml model MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY然后设置环境变量。Linux 或 macOSexport TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell$env:TAOTOKEN_API_KEYYOUR_API_KEY如果你的 Codex 版本对字段有额外要求以接入文档为准。这里最关键的只有两个值Base URL 是 https://taotoken.net/apiKey 通过 TAOTOKEN_API_KEY 环境变量读取。不要把 Base URL 写成带 /v1 的形式也不要把官网 UTM 参数复制进去。UTM 只用于文章里的 CTA 链接不用于 API 请求地址。配置完成后在终端运行codex如果提示缺少 Key、401 或 404先回到第五节的常见错排查。能正常进入会话再让 Codex 分析 QTextEdit 项目。四、拿 Resources/HTML001.html 做验证让 Codex 对照 QTextDocument 支持范围不要一上来就让 Codex 改代码。先做只读分析。把项目目录切到包含 Resources/HTML001.html 和 setHtml 调用文件的根目录然后在 Codex 里输入下面这段提示词只读分析不要修改任何文件。 请读取 Resources/HTML001.html以及项目里调用 QTextEdit.setHtml 的 Python 文件。 输出以下内容 1. HTML001.html 的实际编码是否带 BOM文件开头是否有不可见字符 2. 列出所有 HTML 标签并标出哪些可能不被 QTextDocument 支持 3. 列出 style 和内联 CSS标出 display:flex、grid、position、transform、伪类、CSS 变量等可能被忽略的写法 4. 检查 img src 是网络 URL、相对路径、绝对路径还是反斜杠路径说明当前路径基于哪个目录解析 5. 给出最小验证步骤先把哪些标签或样式删掉只保留 h1、p、strong、em、ul、li、table、img 做测试 6. 不要直接重写我的业务代码只给对照清单和修改建议。成功时Codex 会返回类似这样的结果HTML001.html 编码是 UTF-8 with BOM建议读取时使用 utf-8-sig文件中存在一张 imgsrc 为相对路径 Resources/images/001.png但代码运行目录变化后可能失效style 中有 display:flex 和 grid-template-columnsQTextDocument 大概率忽略有 script 和一个 iframe这两个在 QTextEdit 中不应期待渲染table 标签基本保留但复杂边框和背景可能丢失建议先用行内 style 验证颜色和加粗再单独验证 img 的 QUrl 路径。拿到这些结论后你再回到自己的 QTextEdit 里做最小验证。比如只保留一个 h1、一个 p、一个 ul 和一个 img调用 setHtml 后看 toHtml 返回什么。如果 toHtml 里已经没有某个样式说明 QTextDocument 没解析它如果 toHtml 里有 img 但界面不显示重点查资源路径和 QTextDocument 的资源加载。此时 Codex 的作用是帮你对照不是代替 setHtml 渲染。路径和编码可以先做一层收敛。原来用字符串拼接file和 /Resources/HTML001.html 的方式在开发环境能用打包或切换工作目录后容易出错。可以改成 pathlibfrom pathlib import Path html_path Path(__file__).resolve().parent / Resources / HTML001.html html_text html_path.read_text(encodingutf-8-sig) self.ui.Edit_Show.setHtml(html_text)如果图片仍然不显示检查 HTML001.html 里的 img src。相对路径可以尝试改成基于 html_path.parent 的绝对路径或者用 QUrl.fromLocalFile 生成 file:/// 形式。更稳的方式是给 QTextDocument 添加图片资源再在 HTML 里用自定义名称引用。不要只改 setHtml也不要期待 Codex 帮你绕过 QTextDocument 的资源解析规则。五、本篇常见错排查路径、编码、标签与 Codex 请求下面这些是 QTextEdit 显示 HTML 丢格式时最容易踩的点按出现频率排列。setHtml 后只剩纯文本。先检查传入的字符串是不是已经被转义成 p 这种形式。如果你从 Markdown、CSDN 导出或日志里复制 HTML可能发生了二次转义。QTextDocument 看到 p 只会显示文本不会当作标签解析。标题和加粗在颜色、背景、表格边框丢。这通常是 CSS 支持范围问题。把 class 选择器和外部 style 改成行内 style 先验证例如 stylecolor:#c84b4b;font-weight:700;。如果行内也不生效再用 QTextCharFormat、QTextBlockFormat 手工设置格式。图片不显示。检查 img src。网络 URL、相对路径、反斜杠、中文路径、缺少 file:/// 都可能导致失败。用 Codex 只读分析 HTML001.html 里的 src 形式再在 Python 里打印 html_path 和当前工作目录。相对路径不是基于 HTML 文件本身而是基于运行目录或 QTextDocument 的 baseUrl。中文乱码或第一个标签前多出空白。优先怀疑 BOM 和编码。读取时用 utf-8-sig保存 HTML 时尽量用无 BOM UTF-8。不要用 gbk 读 UTF-8 文件也不要在拼接 HTML 时混用不同编码字符串。列表圆点和缩进丢失。ul、ol、li 基础结构通常能保留但 list-style、复杂 margin、padding 可能被简化。可以先用默认列表验证再逐步加样式。不要假设浏览器里的列表样式在 QTextDocument 里完全一致。QPlainTextEdit 调 setHtml 报 AttributeError。QPlainTextEdit 是纯文本编辑器没有 setHtml。需要富文本就换 QTextEdit如果只是显示日志或代码继续用 setPlainText 和 appendPlainText不要强行塞 HTML。Codex 请求报 401。检查 TAOTOKEN_API_KEY 是否已经导出当前终端是否重启过config.toml 里的 env_key 是否和实际环境变量同名。不要把 Key 直接写进 config.toml 后忘记环境变量名称。Codex 请求报 404 或连接异常。检查 Base URL 是否误写成 https://taotoken.net/api/v1或者复制了带 UTM 的官网地址。正确写法只有 https://taotoken.net/api。API 地址不加 UTM不加多余路径。Codex 能分析但 QTextEdit 仍丢格式。这是正常的。Codex 只能帮你对照 HTML 子集、编码和路径不能替代 Qt 的渲染器。最终判断要看 setHtml 后的 toHtml 结果、图片资源是否加载、以及 QTextDocument 实际支持的标签和 CSS。改了 HTML001.html 但界面没变化。检查你读的是不是同一个文件路径是否被 IDE 工作目录影响Python 是否重新运行。PySide6 应用经常需要重新启动尤其是打包后资源被复制到不同目录时。如果上面这些排查完还是不确定可以把 HTML001.html 精简到最小可复现片段再让 Codex 只读对照。最小片段越短越容易判断到底是标签问题、CSS 问题还是 Resources 路径问题。六、语义一致 CTA用 TaoToken Key 排 QTextEdit 显示问题如果你现在正卡在 QTextEdit.setHtml 丢格式建议按这个顺序处理先到 API Keys 页面创建 Key再按接入文档把 Codex 的 config.toml 配通Base URL 填 https://taotoken.net/api然后用只读提示词让 Codex 对照 Resources/HTML001.html 的标签、CSS、编码和图片路径最后回到 QTextEdit 里做最小验证。创建 Key 和查看接入方式https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentapi-keysCodex 接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentdoc如果你只是想先确认 Key 是否可用可以走模型对话页做一次简单请求https://taotoken.net/console/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentmodel-chat如果你长期用 Codex 做 PySide6 项目排障、资源路径检查和 Agent 工作流可以再了解 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentcoding-plan记住这条边界TaoToken 提供 Key 和 Base URL让 Codex 能接入并分析你的 HTML001.html、编码和 Resources 路径QTextEdit 的 setHtml 最终显示什么仍然由 QTextDocument 的支持范围决定。把 Codex 用在对照和排查上而不是期待它替代 Qt 渲染QTextEdit 多行文本框的 HTML 丢格式问题会好定位得多。