动态语法高亮需严格闭环:DOM结构生成+HTML转义+手动触发highlightElement,缺一不可;hljs.highlightAll()仅扫描初始DOM,对流式内容无效。

动态语法高亮不是“多加个参数就能开自动”,而是必须主动控制 DOM 结构生成 + HTML 转义 + 高亮触发三步闭环,漏掉任一环都会静默失败。
hljs.highlightAll() 为什么对流式内容无效
因为 hljs.highlightAll() 只扫描页面加载完成时已存在的 <pre class="brush:php;toolbar:false;"></code> 元素,它不会监听 DOM 变化。你在 SSE 或 <code>fetch</code> 流中用 <code>innerHTML +=</code> 追加 Markdown 代码块(如 <pre class="brush:php;toolbar:false;">
console.log(1)</pre>),这些文本只是普通字符串,根本没变成 <code><pre class="brush:php;toolbar:false;"><code class="js"></code> 结构,<code>highlightAll()</code> 自然视而不见。</p><ul><li>常见错误现象:<code>document.getElementById('output').innerHTML += '```js\nlet x = 1;\n```'</code> —— 页面显示原样三重反引号,无高亮</li><li>真正要插入的是转换后的 HTML:<code><pre class="brush:php;toolbar:false;"><code class="js">let x = 1;</pre>,不是原始 Markdown
<pre class="brush:php;toolbar:false;"><code></code>,不认 <code>```</code></li></ul><H3>必须先转义再插入,否则 DOM 直接崩</H3><p>你写的示例代码里有 <code><</code>、<code>></code>、<code>&</code>,如果直接 <code>innerHTML = unescapedCode</code>,浏览器会把 <code><div></code> 当成真实标签解析,导致结构错乱、<code><code></code> 被吞掉、高亮失效甚至 XSS 漏洞。</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20cf0281539.jpg" alt="AgentGen — HTML to PDF & Image" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image">AgentGen — HTML to PDF & Image</a>
<p>将 HTML 转换为 PDF 和图片。无需注册,免费版开箱即用(每分钟 1 次请求,含水印)。如需更高频次及去水印……</p>
</div>
<a href="/xiazai/skill13305" title="AgentGen — HTML to PDF & Image" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><ul><li>安全做法只有两种:<code>textContent</code> 插入(但会丢格式)或手动转义</li><li>推荐正则转义(轻量、可控):<code>.replace(/&/g, '&').replace(/</g, '<').replace(/>/g, '>').replace(/"/g, '"')</code></li><li>千万别用 <code>innerHTML</code> 塞未处理的原始代码字符串,哪怕只有一处 <code><</code> 没转,整个 <code><pre class="brush:php;toolbar:false;"><code></code> 就可能被截断</li></ul><H3>动态插入后怎么触发高亮</H3><p>插入完合法的 <code><pre class="brush:php;toolbar:false;"><code class="py"></code> 结构后,得手动告诉 highlight.js:“这里有个新代码块,快去高亮”。不能等,也不能靠全局重扫——尤其页面大时 <code>highlightAll()</code> 性能差且可能重复处理旧节点。</p><ul><li>对单个新元素最稳:<code>const codeEl = container.querySelector('pre:last-child code'); codeEl.className = 'language-python'; hljs.highlightElement(codeEl);</code></li><li>如果一次插入多个代码块,用 <code>highlightAll()</code> 也行,但得确保只执行一次,且在所有新 <code><pre class="brush:php;toolbar:false;"><code></code> 已挂载 DOM 后</li><li>注意语言 class 必须显式写对:<code>language-python</code>、<code>language-html</code>,不能只写 <code>python</code>;highlight.js v11+ 不再自动补前缀</li><li>如果用了 Prism.js,对应调 <code>Prism.highlightElement(codeEl)</code>,逻辑一致</li></ul><H3>Markdown 到 HTML 的转换不能省</H3><p>流式输出(比如 GPT API)返回的是 Markdown 格式文本,不是现成的 HTML。你必须自己写一个轻量转换器,把 <pre class="brush:php;toolbar:false;">
...</pre> 提取出来,转成带 class 和转义内容的 <code><pre class="brush:php;toolbar:false;"><code></code>,再插入 DOM。</pre>
- 核心正则:
/```(\w+)?\n([\s\S]*?)\n```/g,捕获语言和代码体 - 语言为空时默认设为
plaintext,避免 class 缺失 - 转换函数必须同步完成:提取 → 转义 → 拼 HTML → 插入 → 调
highlightElement - 别依赖第三方 Markdown 解析器(如 marked)做这事——太重,且容易多层嵌套破坏结构
最易被忽略的一点:整个流程必须串在同一个微任务里。从拿到流式 chunk,到转成 HTML 字符串,到插入 DOM,再到调 highlightElement,中间不能穿插异步等待或 DOM 重排,否则节点可能还没真正渲染完成,highlightElement 就找不到它。


















