如何为动态加载的 GitHub 代码实现 Highlight.js 语法高亮

夏萱大大_4049

夏萱大大_4049

2026-01-12

679人浏览

原创

如何为动态加载的 GitHub 代码实现 Highlight.js 语法高亮

highlight.js 默认只在页面加载时自动高亮已存在的代码块;对于通过 fetch 异步插入的 github 源码,需手动调用 `hljs.highlightelement()` 触发高亮,否则无法生效。

要在网页中正确高亮从 GitHub(如 raw.githubusercontent.com)动态获取的代码(例如 PowerShell 脚本),关键在于理解 Highlight.js 的执行时机:它默认在 DOM 加载完成时通过 hljs.highlightAll() 扫描并处理所有

<code> 元素。而你使用 fetch() 获取内容并设置 textContent 是<strong>异步操作</strong>,发生在 highlightAll() 之后,因此新插入的代码不会被自动识别。<p>✅ 正确做法是:在代码写入 DOM 后,<strong>显式调用 hljs.highlightElement(element)</strong> 对目标 <code> 元素进行单次高亮。</code></p>
<h3>✅ 完整工作示例</h3>
<pre class="brush:php;toolbar:false;">


  <!-- 样式必须引入(推荐原子主题) -->
  <link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/highlightjs/highlight.js@11.9.0/build/styles/atom-one-dark-reasonable.min.css"><!-- 必须使用 <pre class="brush:php;toolbar:false;"><code> 结构,且指定 language 类(可选但推荐) --><pre class="brush:php;toolbar:false;"><code id="code" class="powershell"></code>
<script src="https://&lt;a%20style=" color: text-decoration:underline title="cdn" href="https://m.php.cn/zt/19618.html" target="_blank">cdn.jsdelivr.net/gh/highlightjs/highlight.js@11.9.0/build/highlight.min.js"></script><script src="https://cdnjs.cloudflare.com/&lt;a%20style=" color: text-decoration:underline title="ajax" href="https://m.php.cn/zt/15849.html" target="_blank">ajax/libs/highlight.js/11.9.0/languages/powershell.min.js"></script><script> // &#21160;&#24577;&#21152;&#36733; GitHub &#21407;&#22987;&#25991;&#20214;&#20869;&#23481; fetch("https://raw.githubusercontent.com/Ayanmullick/test/master/AutomationAcc/test1.ps1") .then(response => { if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`); return response.text(); }) .then(data => { const codeEl = document.getElementById('code'); codeEl.textContent = data; // &#9888;&#65039; &#19981;&#35201;&#29992; innerHTML&#65292;&#36991;&#20813; XSS codeEl.className = 'language-powershell'; // &#26174;&#24335;&#22768;&#26126;&#35821;&#35328;&#65288;&#25552;&#21319;&#26816;&#27979;&#20934;&#30830;&#29575;&#65289; // &#9989; &#20851;&#38190;&#65306;&#25163;&#21160;&#35302;&#21457;&#39640;&#20142; hljs.highlightElement(codeEl); }) .catch(err => { console.error("&#20195;&#30721;&#21152;&#36733;&#22833;&#36133;&#65306;", err); document.getElementById('code').textContent = `// &#21152;&#36733;&#38169;&#35823;&#65306;${err.message}`; }); </script>html>

? 重要注意事项

  • HTML 结构规范:务必使用
    <code id="..."> 包裹目标区域,Highlight.js 依赖此语义结构识别代码块。</code>
  • textContent 而非 innerHTML:防止远程脚本执行(XSS),原始文本渲染更安全。
  • 显式设置 class="xxx":如 language-powershell,可提升语言检测准确性,尤其对无明显特征的脚本。
  • CDN 版本一致性:确保 highlight.min.js、CSS 和语言模块版本号一致(如均用 @11.9.0),避免兼容问题。
  • 错误处理不可少:GitHub raw 链接可能因权限、路径或 CORS 限制失败(注意:GitHub raw 支持 CORS,但私有库不支持),应添加 .catch() 反馈。

? 补充技巧

若需批量高亮多个动态插入的代码块,可用:

从 Git 仓库历史中彻底删除文件
从 Git 仓库历史中彻底删除文件

|Git删除了文件,但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息(密码、密钥、token、私钥) - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件

下载
hljs.highlightAll(); // 重新扫描整个文档(性能略低)
// 或更高效地:
document.querySelectorAll('pre code.language-powershell').forEach(hljs.highlightElement);

总之,异步加载 ≠ 自动高亮;掌握 highlightElement() 是实现动态代码语法高亮的核心钥匙。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
class在c语言中的意思
class在c语言中的意思

在C语言中,"class" 是一个关键字,用于定义一个类。想了解更多class的相关内容,可以阅读本专题下面的文章。

2024.01.03

4176

7

python中class的含义
python中class的含义

本专题整合了python中class的相关内容,阅读专题下面的文章了解更多详细内容。

2025.12.06

306

9

js正则表达式
js正则表达式

php中文网为大家提供各种js正则表达式语法大全以及各种js正则表达式使用的方法,还有更多js正则表达式的相关文章、相关下载、相关课程,供大家免费下载体验。

2023.06.20

4596

8

js获取当前时间
js获取当前时间

JS全称JavaScript,是一种具有函数优先的轻量级,解释型或即时编译型的编程语言;它是一种属于网络的高级脚本语言,主要用于Web,常用来为网页添加各式各样的动态功能。js怎么获取当前时间呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.28

1395

5

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1818

5

js是什么意思
js是什么意思

JS是JavaScript的缩写,它是一种广泛应用于网页开发的脚本语言。JavaScript是一种解释性的、基于对象和事件驱动的编程语言,通常用于为网页增加交互性和动态性。它可以在网页上实现复杂的功能和效果,如表单验证、页面元素操作、动画效果、数据交互等。

2023.08.17

10143

11

js删除节点的方法
js删除节点的方法

js删除节点的方法有:1、removeChild()方法,用于从父节点中移除指定的子节点,它需要两个参数,第一个参数是要删除的子节点,第二个参数是父节点;2、parentNode.removeChild()方法,可以直接通过父节点调用来删除子节点;3、remove()方法,可以直接删除节点,而无需指定父节点;4、innerHTML属性,用于删除节点的内容。

2023.09.01

1000

4

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2884

5

Js中concat和push的区别
Js中concat和push的区别

Js中concat和push的区别:1、concat用于将两个或多个数组合并成一个新数组,并返回这个新数组,而push用于向数组的末尾添加一个或多个元素,并返回修改后的数组的新长度;2、concat不会修改原始数组,是创建新的数组,而push会修改原数组,将新元素添加到原数组的末尾等等。本专题为大家提供concat和push相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.14

1589

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 1.5万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 6.1万人学习

CSS教程
CSS教程

共754课时 | 99.2万人学习