HTML转PDF时<a href>链接失效的主因是PDF生成器未启用可点击链接支持或HTML链接格式不规范；wkhtmltopdf需加--enable-local-file-access和--allow参数，浏览器打印要求链接为完整URL，pdfkit须透传对应参数，且PDF查看器权限也影响链接表现。
HTML 转 PDF 时 <a href> 链接失效的常见原因
不是所有 HTML → PDF 工具都默认保留超链接，尤其是用 wkhtmltopdf、pdfkit 或浏览器打印（Ctrl+P → Save as PDF）时，链接常变成纯文本。根本原因是：PDF 生成器未启用「可点击链接」支持，或 HTML 中链接格式不规范（比如相对路径没补全、缺少协议头）。
wkhtmltopdf 必须加 --enable-local-file-access 和 --allow
本地 HTML 文件含 <a href="file:///..."> 或跳转同目录下其他 HTML，wkhtmltopdf 默认禁止访问本地资源。不加参数就静默丢弃链接。
- 对本地文件：运行时必须带
--enable-local-file-access - 对相对路径（如
<a href="page2.html">）：需用--allow /path/to/dir/显式放行目录 - 确保所有链接带协议：
http://、https://、file://，不能只写page2.html
wkhtmltopdf --enable-local-file-access --allow /home/user/docs/ index.html out.pdf
浏览器打印 PDF 里链接失效？检查 target="_blank" 和协议
Chrome / Edge 的「另存为 PDF」支持超链接，但有两个硬限制：
- 链接必须是完整 URL，
<a href="about.html">不会转成可点击链接，而<a href="https://example.com/about.html">可以 - 含
target="_blank"的链接，在 PDF 中仍能点击，但不会新开窗口（PDF 没窗口概念），这点不影响功能性 - 内联 JavaScript 生成的链接（如
onclick="location.href='...'"）完全不会被识别为超链接
用 pdfkit（Node.js）时漏了 --enable-local-file-access 参数
pdfkit 底层调用的就是 wkhtmltopdf，所以它同样受制于底层参数。直接传 HTML 字符串进去看似绕过路径问题，但一旦链接是相对路径或 file://，仍会失效。
立即学习“前端免费学习笔记（深入）”；
- 必须通过
options透传参数：{ "enable-local-file-access": true, allow: ["/abs/path"] } - 如果 HTML 是字符串而非文件路径，链接最好全用绝对 URL，避免依赖本地解析
- 别信“自动识别”，
pdfkit不会帮你补http://前缀，<a href="//cdn.com/a.js">这种协议相对链接在 PDF 里就是死链
const pdf = await pdfkit.generate('index.html', {
'enable-local-file-access': true,
allow: ['/var/www/html/']
});
真正容易被忽略的是：PDF 查看器本身也影响链接表现。某些老版本 Acrobat Reader 会禁用外部链接，而 macOS 预览（Preview.app）对 file:// 链接默认拦截——这和生成环节无关，是打开环节的权限问题。
