hljs.highlightAll() 不生效的主因是执行时机不当——仅扫描已存在DOM中的<pre><code>元素，且要求<code>含language-xxx类或data-language属性；动态插入、缺语言标识、DOM未就绪、CSS未加载或语言包缺失均会导致失效。
hljs.highlightAll() 不生效的常见原因
调用 hljs.highlightAll() 后代码块没高亮，大概率是执行时机不对——它只扫描当前已存在于 DOM 中的 <pre><code> 元素，且要求 <code> 有明确的 class（如 language-js）或 data-language 属性。如果代码块是后来通过 JS 动态插入的、或缺少语言标识、或脚本在 DOM 加载前就执行了，都会失效。
- 确保 HTML 已完整解析：把
hljs.highlightAll()放在</body>前，或包裹在DOMContentLoaded事件里 - 检查每个
<code>标签是否带语言类名，例如：<code class="python">print("hello")</code>；纯<code>不带 class 默认不处理 - 确认 highlight.js CSS 文件已加载，否则即使标记正确也看不到颜色
必须引入的资源顺序不能错
highlight.js 的 JS 和 CSS 必须按顺序加载，且 CSS 要在 JS 执行前就生效，否则高亮后的标签虽存在但无样式。
- CSS 链接放在
<head>内：<link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/styles/default.min.css"> - JS 脚本放在
</body>前，或使用defer：<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js" defer></script> - 语言包（如需支持 Python/Go 等）要显式引入，否则对应语言不会被识别：
<script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/languages/python.min.js"></script>
动态插入代码后怎么补救
hljs.highlightAll() 是一次性扫描，对后续插入的代码块无效。如果用了 innerHTML、insertAdjacentHTML 或框架（如 Vue 渲染新代码块），得手动调用 hljs.highlightElement()。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 对单个新
<code>元素：获取节点后调用hljs.highlightElement(codeEl) - 若不确定语言，可传入
language参数强制指定：hljs.highlightElement(codeEl, { language: 'json' }) - 避免重复初始化：
hljs.highlightElement()会跳过已处理过的元素（内部打标记），但多次调用无害
自动检测语言失败时怎么办
highlight.js 默认启用 auto-detect，但准确率有限——尤其代码短、语法通用（如 HTML 片段混着 JS）、或没缩进时容易误判为 plaintext。
立即学习“前端免费学习笔记（深入）”；
- 显式声明语言最可靠：用
class="html"比class="html"更稳妥（新版推荐带language-前缀） - 禁用 auto-detect 可减少误标：
hljs.configure({ languages: ['javascript', 'python', 'bash'] })，只加载明确需要的语言 - 遇到
Could not find the language "xxx"错误，说明该语言未加载 JS 文件，补上对应languages/xxx.min.js即可
hljs.highlightAll() 依然会执行并添加 class，但页面毫无变化——你得打开开发者工具看元素上有没有 hljs 类和内联样式，才能确认到底是 JS 还是 CSS 出了问题。** 
