wkhtmltopdf加载URL可执行JS，本地HTML文件无法执行的解决办法

核心原因 #

直接传URL时wkhtmltopdf会加载完整网页资源并执行JS，但本地HTML文件可能存在资源路径错误或JS执行配置未生效的问题，导致mark.js无法正常运行。

解决办法（按推荐度排序） #

1. 后端预渲染高亮（最靠谱，彻底摆脱JS依赖）

既然你已经在渲染HTML文件，不如直接在后端把高亮效果生成好，不用等前端JS处理。你的代码用了ERB，应该是Ruby/Rails栈，直接在后端替换目标文本为<mark>标签即可：

<%
  # 统一处理单字符串或数组的情况
  highlight_terms = Array.wrap(params[:highlighted])
  page_content = @your_doc_page_content
  # 转义特殊字符避免正则出错，替换成带mark标签的内容
  highlight_terms.each do |term|
    page_content = page_content.gsub(Regexp.escape(term), '<mark>\0</mark>')
  end
%>
<div class="doc__page"><%= page_content.html_safe %></div>

生成的HTML本身就带有高亮样式，wkhtmltopdf直接转PDF即可，完全不依赖JS，也不会有重复请求的问题。

2. 修复本地HTML资源路径+强制wkhtmltopdf执行JS

如果不想修改后端，就解决本地文件的JS执行问题：

• 修正mark.js路径：本地HTML用的绝对路径/javascripts/...，wkhtmltopdf加载本地文件时会解析成file:///javascripts/...，必然找不到资源。改成相对路径（比如HTML在项目根目录时，改成./javascripts/mark_highlighter/dist/mark.js），或者直接把mark.js的代码内嵌到HTML的<script>标签里（彻底避免路径问题）。
• 显式启用JS参数：调用wkhtmltopdf时加上强制启用JS和延迟等待的参数，确保JS执行完成：

wkhtmltopdf --enable-javascript --javascript-delay 1000 your_local_file.html output.pdf

--javascript-delay的时间可按需调整（比如2000即2秒），保证mark.js完成高亮处理。

3. 复用已渲染的HTML内容（避免重复请求）

如果一定要用JS处理又不想重复请求URL，可以把第一次请求到的完整渲染后的HTML（包含正确资源路径和ERB替换后的高亮参数）保存下来，再传给wkhtmltopdf，同时加上上述JS启用参数。

注意事项 #

• 你的wkhtmltopdf版本是0.12.6，该版本JS引擎对ES6+支持有限，确保mark.js版本兼容（尽量用ES5版本）。
• 如果用<mark>标签，记得在CSS里定义高亮样式（比如background-color: yellow），避免默认样式不明显。

内容的提问来源于stack exchange，提问作者Max Williams