动态高亮需手动处理:插入前转义并构造成结构,插入后立即调用hljs.highlightElement()并标记data-highlighted防重复。

动态高亮不能靠 hljs.highlightAll() 一次扫完就完事——它只处理初始 DOM,对后续插入的代码块完全无感。必须在每次新内容挂载后,手动提取、转义、结构化、再调用单元素高亮。
✅ 动态插入 Markdown 代码块前,必须先转成 <pre class="brush:php;toolbar:false;"><code></code> 结构</H3><p>Highlight.js 不解析 Markdown 文本,只认 <code><pre class="brush:php;toolbar:false;"><code class="js"></code> 这种 DOM 形态。流式响应(如 SSE 或 fetch + ReadableStream)返回的 <pre class="brush:php;toolbar:false;">
console.log(1)</pre> 是纯文本,直接 <code>innerHTML += 进去,hljs.highlightAll() 压根看不见。
- 用正则匹配三重反引号块:
/```(\w+)?\n([\s\S]*?)\n```/g,注意捕获语言和内容
- 语言为空时默认设为
plaintext,避免 class 变成 language- 这种非法值
- 内容必须 HTML 转义:
& → &、 → <code>、<code>> → >;否则 DOM 解析会塌陷,甚至触发 XSS
- 生成结构严格为:
<pre class="brush:php;toolbar:false;"><code class="js">...</pre>,顺序颠倒或缺任一标签都失效
✅ 插入后立即调用 hljs.highlightElement(),别等 highlightAll()
/```(\w+)?\n([\s\S]*?)\n```/g,注意捕获语言和内容plaintext,避免 class 变成 language- 这种非法值& → &、 → <code>、<code>> → >;否则 DOM 解析会塌陷,甚至触发 XSS
<pre class="brush:php;toolbar:false;"><code class="js">...</pre>,顺序颠倒或缺任一标签都失效hljs.highlightElement(),别等 highlightAll()
highlightAll() 是全量扫描,性能差、且对刚插入的节点可能因渲染延迟而漏掉;highlightElement() 接收单个 <code> 元素,精准、可控、时机明确。
- 插入 HTML 后,用
container.lastElementChild.querySelector('pre code')或更稳妥地用container.querySelectorAll('pre code')找出所有新<code>节点 - 遍历调用
hljs.highlightElement(codeEl),每调一次都确保该块完成高亮 - 若代码块含未知语言(如
language-unknown),可加 fallback:hljs.highlightElement(codeEl, { language: 'plaintext' }) - 不要在插入前就调用——DOM 还没挂载,
codeEl是null
✅ 避免重复高亮:检查 data-highlighted 标记或 class 状态
动态内容可能被多次追加(比如重试、编辑刷新、SPA 路由复用),重复调用 highlightElement() 不报错但浪费性能,还可能导致样式层叠异常(如多重 <span class="hljs-keyword"></span> 嵌套)。
- 插入后给已处理的
<code>加标记:codeEl.setAttribute('data-highlighted', 'true') - 高亮前先判断:
if (!codeEl.hasAttribute('data-highlighted')) { hljs.highlightElement(codeEl); codeEl.setAttribute('data-highlighted', 'true'); } - 不推荐靠 class 判断(如
codeEl.classList.contains('hljs')),因为部分主题不加该 class,不可靠 - 服务端预渲染(SSR)场景下,客户端首次加载需跳过已高亮的块,否则会把服务端生成的
<span></span>再套一层
真正卡住人的不是语法逻辑,而是转义遗漏、结构错位、时机错配这三点——哪怕只漏一个 & 没转成 &,整个 <pre class="brush:php;toolbar:false;"></pre> 就会从 DOM 树里消失,高亮自然失效。动手前先确认三件事:正则是否真能抓到你的代码块、转义是否覆盖全部四种字符、highlightElement() 是否在元素真实存在于 DOM 后才执行。
立即学习“前端免费学习笔记(深入)”;



















