如何使用pdfkit在Python中完整加载网页生成PDF？

核心修复手段 #

• 等待动态内容渲染完成
  多数网页依赖JavaScript异步加载内容，pdfkit默认的抓取时机可能早于渲染结束。可以通过延迟参数让工具等待页面加载：
  命令行方式：

  pdfkit --javascript-delay 3000 target-url output.pdf
  

  Python代码调用：

  import pdfkit
  options = {'javascript-delay': 3000}
  pdfkit.from_url('目标网页地址', 'output.pdf', options=options)
  

• 适配响应式页面布局
  部分响应式页面在小视口下会隐藏或折叠内容，可指定视口尺寸强制加载完整布局：

  options = {
      'viewport-size': '1920x1080',
      'javascript-delay': 3000
  }
  pdfkit.from_url('目标网页地址', 'output.pdf', options=options)
  

• 禁用智能压缩与缓存
  工具的智能压缩可能导致内容截断，缓存也可能加载旧数据，可通过参数关闭：

  pdfkit --no-cache --disable-smart-shrinking target-url output.pdf
  

• 等待特定异步元素加载
  如果页面有大量AJAX请求，单纯延迟不够，可注入脚本等待目标元素加载完成：

  options = {
      'run-script': """
          window.onload = function() {
              const checkLoaded = setInterval(() => {
                  const target = document.getElementById('动态内容容器ID');
                  if (target && target.textContent.trim()) {
                      clearInterval(checkLoaded);
                      window.status = 'ready';
                  }
              }, 500);
          };
      """,
      'window-status': 'ready'
  }
  pdfkit.from_url('目标网页地址', 'output.pdf', options=options)
  

内容的提问来源于stack exchange，提问作者Sadman Shakib