根本原因是Prism.js/Highlight.js默认禁用touchstart事件且iOS Safari对DOMContentLoaded和requestIdleCallback执行时机敏感，导致高亮逻辑未运行；典型表现为code元素class未替换、token未生成，手动调用highlightAll()也无效。
HTML5 页面在 iPad 上代码块高亮失效，根本原因不是「不支持」，而是 Prism.js / Highlight.js 等主流高亮库默认禁用了 touchstart 事件监听（为避免移动端误触发），而 iOS Safari 的早期版本（尤其是 iOS 12–15）对 DOMContentLoaded 和 requestIdleCallback 的执行时机敏感，导致高亮逻辑未真正运行。
Prism.js 在 iPad 上不触发高亮的典型表现
页面加载后，<code class="js">...</code> 元素存在，但 class 没被替换为 <code>language-js prism-language-js</code>，也没有生成 token <code><span class="token function"></span></code> 等结构。控制台无报错，<code>Prism.highlightAll()</code> 手动调用也无效——这说明高亮器没进入「实际工作状态」，而非语法解析失败。
常见诱因包括：
- iOS Safari 启用「限制网站跟踪」后，
requestIdleCallback被静默降级或跳过 - Prism 初始化早于
<code></code> DOM 插入（比如通过 <code>innerHTML</code> 动态写入）
- 使用了
prismjs/components/prism-core.min.js但漏载语言插件（如prismjs/components/prism-javascript.min.js）
强制在 iPad 上触发 Prism 高亮的可靠写法
不用等 DOMContentLoaded，改用更稳妥的时机 + 显式触发。关键是绕过 Prism 内部的「空闲回调依赖」：
document.addEventListener('DOMContentLoaded', () => {
// 确保 DOM 就绪
if (typeof Prism !== 'undefined') {
// 强制同步执行，不依赖 requestIdleCallback
Prism.highlightAllUnder(document.body);
// 补充：若代码块是 later 插入的（如 AJAX 加载），需手动调用
// Prism.highlightElement(codeEl);
}
});
如果仍无效，加一层 iOS 特判并延迟执行（iOS WebKit 渲染队列有时滞后）：
if (/iPad|iPhone|iPod/.test(navigator.userAgent)) {
setTimeout(() => {
Prism.highlightAll();
}, 300);
}
Highlight.js 的 iPad 兼容补丁
Highlight.js 默认在 DOMContentLoaded 后自动初始化，但在 iPad 上可能错过节点。必须显式调用 highlightAll()，且不能依赖模块自动加载：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 确保已加载完整版
highlight.min.js（非highlight-core.min.js） - 确认语言文件（如
javascript.min.js）已通过hljs.registerLanguage('javascript', ...)注册 - 禁用自动初始化：在 script 标签中添加
data-autoloader="false"
然后手动启动：
document.addEventListener('DOMContentLoaded', () => {
hljs.highlightAll();
});
若用 ES 模块方式引入，注意 iOS Safari 对 import() 动态导入的支持较晚（iOS 14+ 稳定），旧版需回退到 script 标签加载。
检查 Safari 设置与 meta 标签干扰
iPad 上某些「阅读模式」或「内容拦截器」会剥离 <script></script> 或重写 DOM。务必确认：
-
存在且未被覆盖 - 未启用
后又漏配 manifest，导致 Safari 切换为「App 模式」并禁用部分 JS 行为 - Safari 设置中「阻止所有 Cookie」或「隐藏 IP 地址」未意外影响本地脚本执行（可临时关闭验证）
最简验证法：在 iPad Safari 中打开页面，直接在控制台输入 Prism.highlightAll() 或 hljs.highlightAll() —— 若此时高亮生效，说明只是初始化时机问题；若仍无效，则是资源加载或环境限制问题。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
