比较

TuesPechkin 与 IronPDF：技术比较指南

已更新:

TuesPechkinvs IronPDF：.NET PDF 生成技术比较

当.NET 开发人员需要将 HTML 转换为 PDF 时，有几个围绕传统渲染引擎构建的封装库可供选择。TuesPechkin就是这样一种解决方案，它封装了 wkhtmltopdf 库，提供 PDF 生成功能。 本技术比较将研究TuesPechkin和 IronPDF，以帮助架构师和开发人员了解传统封装器和现代 PDF 库之间的权衡。

了解 TuesPechkin。

TuesPechkin 是 wkhtmltopdf 库的线程安全封装程序，旨在帮助开发人员从 HTML 内容生成 PDF 文档。 该库试图通过提供 ThreadSafeConverter 实现来解决 wkhtmltopdf 固有的并发性难题。

但TuesPechkin继承了其底层技术的基本局限性：

  • 已废弃的基金会:TuesPechkin对 wkhtmltopdf 进行了包装，wkhtmltopdf 最后一次更新是在 2015 年，并于 2022 年 12 月正式废弃。
  • 过时的渲染引擎：使用前 Chrome 时代的呈现引擎 Qt WebKit 4.8
  • 复杂线程管理：要求开发人员通过 RemotingToolset 和部署模式手动配置线程安全
  • 负载下的稳定性：即使进行了线程安全配置，该库仍可能在高并发情况下崩溃，出现 AccessViolationException 或进程挂起。
  • 有限的 CSS 支持：不支持 Flexbox 或 CSS Grid 等现代 CSS 功能
  • JavaScript 限制：JavaScript 执行不可靠，不支持 ES6+

安全考虑因素

TuesPechkin 继承了 wkhtmltopdf 的所有安全漏洞。 CVE-2022-35583 被评为 "严重"（9.8/10），是一个影响所有TuesPechkin版本的服务器端请求伪造漏洞。 由于 wkhtmltopdf 已被弃用，此漏洞将永远不会被修补，这意味着使用TuesPechkin的应用程序将永远暴露在漏洞中。

了解IronPDF

IronPDF 采用了一种根本不同的方法，它提供了一个具有本地线程安全和基于 Chromium 的渲染引擎的现代商用 PDF 库。IronPDF 并未对传统工具进行封装，而是将 PDF 生成作为其主要重点。

IronPDF的主要特点包括：

  • 现代 Chromium 引擎：完全支持 HTML5、CSS3、Flexbox、CSS Grid 和 ES6+ JavaScript
  • 原生线程安全：无需手动线程管理--并发操作自动运行
  • 积极开发：每周更新并持续改进
  • 全面的 PDF 功能：除生成功能外，还包括操作、数字签名、PDF/A 合规性和表格填写功能
  • 简单集成：直接安装 NuGet，无需本地二进制部署

功能对比

下表重点介绍了TuesPechkin和 IronPdf 之间的技术差异：

特征TuesPechkinIronPDF
许可免费（MIT 许可）商业翻译
线程安全需要人工管理本地支持
货币有局限性，在负载情况下可能会崩溃稳健，可处理高并发
开发状态不活跃，最后更新时间为 2015 年积极、持续的改进
易用性复杂的设置方便用户使用的指南
文档基本的包含大量示例
渲染引擎Qt WebKit 4.8（已过时）现代 Chromium
CSS3 支持。部分翻译全面支持
Flexbox/网格不支持全面支持
JavaScript语言不可靠完整的 ES6+
PDF 操作不可用全面支持
数字签名不可用全面支持
PDF/A合规性不可用全面支持
表格填写不可用全面支持
水印。不可用全面支持
合并/拆分不可用全面支持
页眉/页脚仅限基本文本完全支持 HTML
安全补丁永不（放弃）定期更新

API 架构差异

在研究初始化模式和基本用法时，可以立即发现TuesPechkin和IronPDF在架构上的差异。

TuesPechkin初始化复杂性

TuesPechkin 需要一个复杂的初始化过程，涉及转换器、工具集和部署配置：

// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        string html = "<html><body><h1>Hello World</h1></body></html>";
        byte[] pdfBytes = converter.Convert(new HtmlToPdfDocument
        {
            Objects = { new ObjectSettings { HtmlText = html } }
        });

        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}
// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        string html = "<html><body><h1>Hello World</h1></body></html>";
        byte[] pdfBytes = converter.Convert(new HtmlToPdfDocument
        {
            Objects = { new ObjectSettings { HtmlText = html } }
        });

        File.WriteAllBytes("output.pdf", pdfBytes);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这种模式要求理解多个嵌套类：StandardConverter, RemotingToolset, Win64EmbeddedDeployment, 和 TempFolderDeployment. 部署配置也必须与目标平台架构（x86/x64）相匹配。

IronPDF简化方法

IronPdf 通过简单明了的 API 完全消除了部署的复杂性：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("output.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        string html = "<html><body><h1>Hello World</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("output.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

ChromePdfRenderer 类可立即访问 PDF 生成，无需特定平台配置。 有关全面的 HTML 转换指导，请参阅 HTML 转 PDF 教程。

将 URL 转换为 PDF.

将网页转换为 PDF 文档展示了两个库之间的 API 可用性差异。

TuesPechkin实现

TuesPechkin 使用 ObjectSettings 中的 PageUrl 属性指定 URL：

// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        byte[] pdfBytes = converter.Convert(new HtmlToPdfDocument
        {
            Objects = {
                new ObjectSettings {
                    PageUrl = "https://www.example.com"
                }
            }
        });

        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}
// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        byte[] pdfBytes = converter.Convert(new HtmlToPdfDocument
        {
            Objects = {
                new ObjectSettings {
                    PageUrl = "https://www.example.com"
                }
            }
        });

        File.WriteAllBytes("webpage.pdf", pdfBytes);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

由于缺少 CSS3 和 JavaScript 支持，过时的 WebKit 引擎可能会错误地呈现现代网站。

IronPdf 的实现

IronPDF 利用其现代 Chromium 引擎为 URL 渲染提供了专用方法：

// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");

        pdf.SaveAs("webpage.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        var pdf = renderer.RenderUrlAsPdf("https://www.example.com");

        pdf.SaveAs("webpage.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

RenderUrlAsPdf 方法可在无头 Chromium 浏览器中加载页面，执行 JavaScript 并准确应用所有现代 CSS 样式。 这对于使用 React、Angular 或 Vue.js 等框架构建的网络应用程序至关重要，因为TuesPechkin无法正确呈现这些网络应用程序。

自定义渲染设置

配置页面尺寸、页边距和方向揭示了文档设置的不同方法。

TuesPechkin配置

TuesPechkin 使用带有嵌套配置的 GlobalSettings 和 ObjectSettings 类：

// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        string html = "<html><body><h1>Custom PDF</h1></body></html>";

        var document = new HtmlToPdfDocument
        {
            GlobalSettings = {
                Orientation = GlobalSettings.PdfOrientation.Landscape,
                PaperSize = GlobalSettings.PdfPaperSize.A4,
                Margins = new MarginSettings { Unit = Unit.Millimeters, Top = 10, Bottom = 10 }
            },
            Objects = {
                new ObjectSettings { HtmlText = html }
            }
        };

        byte[] pdfBytes = converter.Convert(document);
        File.WriteAllBytes("custom.pdf", pdfBytes);
    }
}
// NuGet: Install-Package TuesPechkin
using TuesPechkin;
using System.IO;

class Program
{
    static void Main()
    {
        var converter = new StandardConverter(
            new RemotingToolset<PdfToolset>(
                new Win64EmbeddedDeployment(
                    new TempFolderDeployment())));

        string html = "<html><body><h1>Custom PDF</h1></body></html>";

        var document = new HtmlToPdfDocument
        {
            GlobalSettings = {
                Orientation = GlobalSettings.PdfOrientation.Landscape,
                PaperSize = GlobalSettings.PdfPaperSize.A4,
                Margins = new MarginSettings { Unit = Unit.Millimeters, Top = 10, Bottom = 10 }
            },
            Objects = {
                new ObjectSettings { HtmlText = html }
            }
        };

        byte[] pdfBytes = converter.Convert(document);
        File.WriteAllBytes("custom.pdf", pdfBytes);
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

IronPDF配置

IronPDF 通过直观的属性名称将设置集中在 RenderingOptions 属性中：

// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;

        string html = "<html><body><h1>Custom PDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("custom.pdf");
    }
}
// NuGet: Install-Package IronPdf
using IronPdf;
using IronPdf.Engines.Chrome;
using System;

class Program
{
    static void Main()
    {
        var renderer = new ChromePdfRenderer();

        renderer.RenderingOptions.PaperOrientation = PdfPaperOrientation.Landscape;
        renderer.RenderingOptions.PaperSize = PdfPaperSize.A4;
        renderer.RenderingOptions.MarginTop = 10;
        renderer.RenderingOptions.MarginBottom = 10;

        string html = "<html><body><h1>Custom PDF</h1></body></html>";
        var pdf = renderer.RenderHtmlAsPdf(html);

        pdf.SaveAs("custom.pdf");
    }
}
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

RenderingOptions 类提供了一种统一的配置方法，在该方法中，边距值直接以毫米为单位指定，而无需包装对象。

线程安全和并发性

线程安全是服务器端 PDF 生成的一个重要考虑因素，而这两个库采用了根本不同的方法。

TuesPechkin线程管理

TuesPechkin 通过其ThreadSafeConverter宣传线程安全操作，但其实现具有记录的局限性：

//TuesPechkin- Even with ThreadSafeConverter, crashes under load
var converter = new TuesPechkin.ThreadSafeConverter(
    new TuesPechkin.RemotingToolset<PechkinBindings>());

// Under high load, applications may experience:
// - System.AccessViolationException
// - StackOverflowException
// - Process hangs indefinitely
// - Memory corruption
//TuesPechkin- Even with ThreadSafeConverter, crashes under load
var converter = new TuesPechkin.ThreadSafeConverter(
    new TuesPechkin.RemotingToolset<PechkinBindings>());

// Under high load, applications may experience:
// - System.AccessViolationException
// - StackOverflowException
// - Process hangs indefinitely
// - Memory corruption
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

底层的 wkhtmltopdf 库并不是为高并发场景而设计的，即使采用了封装级线程管理，在高负载情况下仍会出现稳定性问题。

IronPDF本地并发性

IronPdf 提供本地线程安全，无需任何配置：

//IronPDF- Native thread safety
var renderer = new ChromePdfRenderer();

// Safe for concurrent use across multiple threads
// No AccessViolationException
// No process hangs
// Stable under high load
//IronPDF- Native thread safety
var renderer = new ChromePdfRenderer();

// Safe for concurrent use across multiple threads
// No AccessViolationException
// No process hangs
// Stable under high load
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

ChromePdfRenderer在内部处理并发性，允许开发人员专注于应用程序逻辑而非线程同步。

支持现代 CSS 和 JavaScript.

在使用现代网络技术时，TruesPechkin 和IronPDF之间的渲染引擎差异最为明显。

TuesPechkin渲染限制

TuesPechkin 的 Qt WebKit 4.8 引擎早于现代 CSS 布局系统：

<!-- This modern CSS doesn't work inTuesPechkin-->
<div style="display: flex; justify-content: space-between; gap: 20px;">
    <div style="flex: 1;">Column 1</div>
    <div style="flex: 1;">Column 2</div>
</div>

<div style="display: grid; grid-template-columns: repeat(3, 1fr);">
    <div>Grid Item 1</div>
    <div>Grid Item 2</div>
    <div>Grid Item 3</div>
</div>
<!-- This modern CSS doesn't work inTuesPechkin-->
<div style="display: flex; justify-content: space-between; gap: 20px;">
    <div style="flex: 1;">Column 1</div>
    <div style="flex: 1;">Column 2</div>
</div>

<div style="display: grid; grid-template-columns: repeat(3, 1fr);">
    <div>Grid Item 1</div>
    <div>Grid Item 2</div>
    <div>Grid Item 3</div>
</div>
HTML

使用TuesPechkin的应用程序必须依靠基于表格的布局或其他 CSS2.1 变通方法来实现多栏设计。

IronPDF现代渲染

IronPdf 的 Chromium 引擎支持所有现代 CSS 和 JavaScript：

// Modern CSS works correctly with IronPDF
var html = @"
    <div style='display: flex; justify-content: space-between;'>
        <div>Left</div>
        <div>Right</div>
    </div>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
// Renders correctly with full Flexbox support
// Modern CSS works correctly with IronPDF
var html = @"
    <div style='display: flex; justify-content: space-between;'>
        <div>Left</div>
        <div>Right</div>
    </div>";

var renderer = new ChromePdfRenderer();
var pdf = renderer.RenderHtmlAsPdf(html);
// Renders correctly with full Flexbox support
IRON VB CONVERTER ERROR developers@ironsoftware.com
$vbLabelText   $csharpLabel

这样，开发人员就可以使用相同的 HTML/CSS 进行网页显示和 PDF 生成，而无需维护单独的模板。

当团队考虑替代TuesPechkin时

有几种情况通常会促使开发团队评估TuesPechkin的替代方案：

安全要求

随着 CVE-2022-35583 被评为危急（9.8/10），以及底层 wkhtmltopdf 库被正式放弃，有安全合规性要求的组织不能继续使用 TuesPechkin。 SSRF 漏洞允许攻击者通过恶意 HTML 内容访问内部网络、窃取凭证和外泄数据。

现代网络技术的采用

采用现代前端框架（React、Angular、Vue.js）或 CSS 布局系统（Flexbox、Grid）的团队发现TuesPechkin无法准确呈现他们的内容。 过时的 WebKit 4.8 引擎不支持近十年来一直作为标准的技术。

负载下的稳定性

服务器端应用程序在并发 PDF 生成负载下遇到崩溃、挂起或 AccessViolationException 错误时，通常会将这些问题归咎于TuesPechkin的线程限制。 即使使用 ThreadSafeConverter 配置，底层 wkhtmltopdf 库也不是为高并发环境而设计的。

PDF 功能要求

TuesPechkin 只提供 HTML 到 PDF 的转换。 需要进行 PDF 操作（合并、拆分）、数字签名、PDF/A 合规性、表格填充或水印的团队必须添加额外的库，或考虑IronPDF等原生提供这些功能的替代工具。

简化部署

带有 RemotingToolset, Win64EmbeddedDeployment 和 TempFolderDeployment 的TuesPechkin初始化模式增加了部署的复杂性。 必须为每个目标环境正确配置特定平台的本地二进制文件。IronPDF通过标准的 NuGet 安装消除了这种复杂性。

API 映射参考

正在评估从TuesPechkin向IronPDF过渡的团队会发现此映射有助于理解概念等同：

TuesPechkinIronPDF备注
<代码>标准转换器</代码> / <代码>线程安全转换器</代码<代码>ChromePdfRenderer</代码无需线程管理
<代码>HtmlToPdfDocument</代码方法参数直接输入 HTML 字符串
<代码>GlobalSettings.PaperSize</代码<代码>RenderingOptions.PaperSize</代码提供相同尺寸的纸张
<代码>GlobalSettings.Orientation</代码<代码>RenderingOptions.PaperOrientation</代码肖像/风景
<代码>GlobalSettings.Margins</代码<代码>RenderingOptions.MarginTop/Bottom/Left/Right</代码直接毫米值
<代码>ObjectSettings.HtmlText</代码<代码>RenderHtmlAsPdf(html)</代码HTML 内容参数
<代码>ObjectSettings.PageUrl</代码<代码>RenderUrlAsPdf(url)</代码URL 呈现方法
<代码>远程工具集</代码> + <代码>部署</代码不需要自动部署
<代码>[页面]</代码>占位符{page} 占位符页码语法
<代码>[toPage]</代码>占位符{total-pages} 占位符总页数语法

其他 PDF 功能

除了 HTML 到 PDF 的转换之外，IronPDF 还提供了TuesPechkin无法提供的文档操作功能：

.NET兼容性和未来准备情况

TuesPechkin 的非活跃开发状态意味着不会对较新的 .NET 版本进行更新。IronPDFfor .NET 保持着定期更新的积极开发态势，确保与 .NET 8、.NET 9 和未来版本（包括预计于 2026 年发布的 .NET 10）的兼容性。该库的整个 API 均支持 async/await，符合现代 C# 开发实践，包括 C# 13 中的可用功能和预期的 C# 14 功能。

结论

TuesPechkin 和IronPDF代表了 .NET PDF 生成的不同时代。TuesPechkin提供了一个免费的、获得 MIT 许可的 wkhtmltopdf 封装器，但继承了严重的安全漏洞、过时的渲染引擎、复杂的线程管理要求以及负载下的稳定性问题。 底层技术已于 2022 年被弃用，没有安全补丁。

IronPDF 提供了一个现代化的、积极维护的替代方案，其基于 Chromium 的渲染引擎支持当前的网络技术。 它的本地线程安全性、全面的 PDF 功能和直接的 API 设计解决了 wkhtmltopdf 封装器固有的局限性。

对于目前使用TuesPechkin的团队来说，迁移的决定往往源于安全要求、渲染质量需要、稳定性问题或对基本 HTML 转换之外的 PDF 功能的要求。 这两个库之间的 API 映射简单明了，IronPDF 由于简化了初始化和配置模式，通常需要较少的代码。

有关更多实施指导，请浏览 IronPDF 文档和涵盖特定用例和高级功能的 教程。