我之前也踩过超大HTML转PDF的坑，不管是Node.js还是CLI工具都碰到过卡顿的问题，给你几个经过验证的解决方案，分不同技术栈来说：

JavaScript/Node.js 方案：改用 Puppeteer 替代 html-pdf #

你之前用的html-pdf库依赖的是已经停止维护的PhantomJS，对大文件的内存处理和渲染支持很差，换成Puppeteer（Chrome无头浏览器）会稳定很多，而且还能监控处理进度。

示例代码 #

首先安装依赖：

npm install puppeteer

然后编写转换函数，支持进度监控和内存优化：

const fs = require('fs');
const puppeteer = require('puppeteer');

async function largeHtmlToPdf(htmlPath, pdfPath) {
  // 启动Chrome时添加内存优化参数
  const browser = await puppeteer.launch({
    args: [
      '--disable-dev-shm-usage', // 避免容器/低内存环境的共享内存限制
      '--no-sandbox',
      '--disable-gpu',
      '--max-old-space-size=4096' // 调整V8堆内存，根据你的机器配置改
    ]
  });

  const page = await browser.newPage();
  
  // 监听页面加载日志，用来跟踪进度
  page.on('console', msg => {
    if (msg.text().startsWith('progress:')) {
      console.log(`转换进度：${msg.text().split(':')[1]}%`);
    }
  });

  // 读取大HTML文件，超大型文件可改用流式加载进一步优化内存
  const htmlContent = fs.readFileSync(htmlPath, 'utf8');
  
  // 在HTML末尾添加进度监控脚本（可选，用于跟踪渲染进度）
  const htmlWithProgress = htmlContent + `
    <script>
      const totalElements = document.querySelectorAll('*').length;
      let processed = 0;
      const observer = new MutationObserver(() => {
        processed++;
        const progress = Math.round((processed / totalElements) * 100);
        console.log('progress:' + progress);
        if (progress === 100) observer.disconnect();
      });
      observer.observe(document.body, { childList: true, subtree: true });
    </script>
  `;

  await page.setContent(htmlWithProgress, {
    waitUntil: 'networkidle0' // 等待网络请求全部完成再渲染
  });

  // 生成PDF，设置必要的格式选项
  await page.pdf({
    path: pdfPath,
    format: 'Letter',
    printBackground: true // 如果有背景样式需要开启
  });

  await browser.close();
  console.log('PDF转换完成！');
}

// 调用函数
largeHtmlToPdf('input.html', 'output.pdf').catch(err => console.error(err));

关键优化点 #

• 用Puppeteer的内存优化参数避免卡顿
• 添加进度监控脚本，通过console事件跟踪转换进度
• 用networkidle0确保页面完全加载后再生成PDF

Python 方案：使用 WeasyPrint 或 Pyppeteer #

方案1：WeasyPrint（轻量高效，基于CSS渲染） #

WeasyPrint对大HTML的内存管理做得很好，不需要依赖浏览器引擎，适合纯静态HTML的转换。

首先安装依赖：

pip install weasyprint

示例代码：

from weasyprint import HTML

def html_to_pdf(html_path, pdf_path):
    # 加载HTML文件，支持流式处理大文件
    html = HTML(filename=html_path)
    # 生成PDF，可设置页面大小、边距等
    html.write_pdf(
        pdf_path,
        presentational_hints=True,
        stylesheets=None, # 如果有外部CSS可以传入路径列表
        page_size='letter'
    )
    print("PDF转换完成！")

html_to_pdf('input.html', 'output.pdf')

方案2：Pyppeteer（Puppeteer的Python版，支持复杂JS渲染） #

如果你的HTML包含大量JavaScript动态内容，用Pyppeteer更合适：

安装依赖：

pip install pyppeteer

示例代码：

import asyncio
from pyppeteer import launch

async def large_html_to_pdf(html_path, pdf_path):
    browser = await launch(
        args=['--disable-dev-shm-usage', '--no-sandbox', '--max-old-space-size=4096']
    )
    page = await browser.newPage()
    
    # 读取HTML内容
    with open(html_path, 'r', encoding='utf-8') as f:
        html_content = f.read()
    
    await page.setContent(html_content, waitUntil='networkidle0')
    await page.pdf({
        'path': pdf_path,
        'format': 'Letter',
        'printBackground': True
    })
    
    await browser.close()
    print("PDF转换完成！")

asyncio.get_event_loop().run_until_complete(large_html_to_pdf('input.html', 'output.pdf'))

CLI 工具优化方案：修复 wkhtmltopdf 卡顿或改用 Chrome Headless #

方案1：优化 wkhtmltopdf 参数 #

你之前用wkhtmltopdf卡在50%，大概率是内存限制或JS执行阻塞的问题，试试添加这些参数：

wkhtmltopdf --disable-javascript --no-stop-slow-scripts --enable-local-file-access --page-size Letter input.html output.pdf

• --disable-javascript：如果HTML不需要JS渲染，直接禁用可以大幅提升速度
• --no-stop-slow-scripts：避免因为慢脚本导致卡住
• --enable-local-file-access：确保能加载本地资源（比如CSS、图片）

如果还是卡顿，可以尝试分块转换：

1. 把大HTML拆分成多个小HTML文件（比如按章节拆分）
2. 分别转成多个PDF
3. 用pdftk或qpdf合并PDF：

   pdftk part1.pdf part2.pdf ... cat output combined.pdf
   

方案2：改用 Chrome Headless CLI #

Chrome的无头模式渲染大HTML比wkhtmltopdf更稳定，命令如下：

chrome --headless --disable-gpu --print-to-pdf=output.pdf input.html

（Windows平台需替换为Chrome的完整路径，比如"C:\Program Files\Google\Chrome\Application\chrome.exe"）

内容的提问来源于stack exchange，提问作者Piyush Dubey