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

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











