MIGRATION GUIDES

How to Migrate from MuPDF to IronPDF in C#

Curtis Chau

發表日期:2026年1月25日

為什麼要從 PDF格式遷移到 IronPDF

MuPDF挑戰賽

MuPDF 是一款優秀的 PDF 渲染器，但其 AGPL 授權和僅專注於渲染功能，為建立商業應用程式的 .NET 開發人員帶來了巨大的限制：

AGPL 許可陷阱： PDF格式的病毒式許可要求要么將整個應用程式開源為 AGPL，要么購買價格昂貴且不透明的商業許可，並透過聯繫銷售進行定價。

2.僅渲染功能： PDF格式是一個檢視器/渲染器－它並非設計用於從 HTML 建立 PDF、文件產生工作流程、表單填寫或新增浮水印和頁首/頁尾。

3.不支援 HTML： PDF格式不支援直接將 HTML 轉換為 PDF。您需要先使用其他程式庫將 HTML 轉換為支援的格式。這是一個根本性的限制——MuPDF 主要是 PDF 渲染器/檢視器。

4.本機相依性：特定於平台的二進位檔案需要手動管理，適用於 Windows、Linux 和 macOS。 Docker 部署會因對原生程式庫的要求而變得複雜，部署打包也會帶來挑戰。

5.操作有限：不支援合併/分割 PDF、頁面旋轉或重新排序、浮水印或註釋、數位簽章等內建功能。

C 互通複雜性：原生綁定引入了記憶體管理問題、平台特定的錯誤和編組開銷。

PDF格式與 IronPDF 對比

特徵	PDF格式	IronPDF
執照	AGPL（病毒式傳播）或昂貴的商業用途	商業定價透明
主要關注點	渲染/檢視	完整的 PDF 解決方案
HTML 轉 PDF	不支援	全鉻發動機
PDF 建立	不支援	HTML、URL、圖片
PDF 處理	有限的	完成（合併、拆分、編輯）
依賴關係	本地二進位文件	全託管
平台支援	手動按平台操作	自動的
非同步支援	有限的	完全異步/等待
.NET 集成	C 互通	Native .NET

對於計劃在 2025 年和 2026 年採用 .NET 10 和 C# 14 的團隊來說，IronPDF 提供了一個面向未來的基礎，它是一個完全託管的 .NET 庫，沒有原生互通的複雜性。

遷移複雜度評估

各功能預計工作量

特徵	遷移複雜性	筆記
文件載入中	非常低	直接替代法
文字擷取	非常低	更簡單的 API
PDF合併	低的	靜態方法與手動循環
影像渲染	低的	RasterizeToImageFiles 與像素圖
HTML 轉 PDF	不適用（新增功能）	PDF格式中無法實現
安全/浮水印	不適用（新增功能）	PDF格式中無法實現

範式轉移

MuPDF此次遷移的根本轉變在於從僅用於渲染的檢視器轉變為完整的PDF解決方案：

MuPDF：MuPDFContext → MuPDFDocument → 頁面迭代 → 僅渲染/擷取
IronPDF：PdfDocument.FromFile() → 完全操作 → 建立/編輯/合併/加固

開始之前

先決條件

.NET 環境： .NET Framework 4.6.2+ 或 .NET Core 3.1+ / .NET 5/6/7/8/9+
NuGet 存取權限：能夠安裝 NuGet 套件
IronPDF 許可證：請從ironpdf.com取得您的許可證密鑰。

NuGet 套件變更

# Remove PDF格式 packages
dotnet remove package MuPDF.NET
dotnet remove package MuPDFCore
dotnet remove package MuPDFCore.MuPDFWrapper

# Install IronPDF
dotnet add package IronPdf

# Remove PDF格式 packages
dotnet remove package MuPDF.NET
dotnet remove package MuPDFCore
dotnet remove package MuPDFCore.MuPDFWrapper

# Install IronPDF
dotnet add package IronPdf

SHELL

同時從部署環境中移除原生 PDF格式二進位檔案：

刪除mupdf.dll 、 libmupdf.so 、 libmupdf.dylib
刪除平台特定資料夾（ runtimes/*/native/ ）
更新 Docker 檔案以移除 PDF格式安裝

許可證配置

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

// Add at application startup (Program.cs or Startup.cs)
IronPdf.License.LicenseKey = "YOUR-LICENSE-KEY";

$vbLabelText $csharpLabel

識別 PDF格式使用情況

# Find all PDF格式 references
grep -r "MuPDF\|MuPDFCore\|MuPDFDocument" --include="*.cs" .

# Find all PDF格式 references
grep -r "MuPDF\|MuPDFCore\|MuPDFDocument" --include="*.cs" .

SHELL

完整 API 參考

文件載入中

PDF格式	IronPDF	筆記
`new MuPDFDocument(path)`	`PdfDocument.FromFile(path)`	從檔案載入
`new MuPDFDocument(stream)`	`PdfDocument.FromStream(stream)`	從串流中載入
`document.Dispose()`	`pdf.Dispose()`	清理

頁面訪問

PDF格式	IronPDF	筆記
`document.Pages.Count`	`pdf.PageCount`	頁數
`document.Pages[index]`	`pdf.Pages[index]`	訪問頁面
`page.GetText()`	`page.Text`	頁面文本

文字擷取

PDF格式	IronPDF	筆記
遍歷`document.Pages[i].GetText()`	`pdf.ExtractAllText()`	一次顯示所有文本

PDF 建立（MuPDF 中不可用）

PDF格式	IronPDF	筆記
（不支持）	`ChromePdfRenderer.RenderHtmlAsPdf(html)`	HTML 轉 PDF
（不支持）	`ChromePdfRenderer.RenderUrlAsPdf(url)`	PDF檔案的URL

PDF 操作（MuPDF 中的限制）

PDF格式	IronPDF	筆記
手動頁面複製循環	`PdfDocument.Merge(pdf1, pdf2)`	合併PDF
（不支持）	`pdf.ApplyWatermark(html)`	添加浮水印
（不支持）	`pdf.SecuritySettings`	密碼保護

程式碼遷移範例

範例 1：HTML 轉 PDF（MuPDF 無法完成此操作）

之前（PDF格式）：

// NuGet: Install-Package MuPDF.NET
using MuPDFCore;
using System.IO;

class Program
{
    static void Main()
    {
        // PDF格式 doesn't support HTML 轉 PDF conversion directly
        // You would need to use another library to convert HTML to a supported format first
        // This is a limitation - PDF格式 is primarily a PDF renderer/viewer

        // Alternative: Use a browser engine or intermediate conversion
        string html = "<html><body><h1>Hello World</h1></body></html>";

        // Not natively supported in MuPDF
        throw new NotSupportedException("MuPDF does not support direct HTML 轉 PDF conversion");
    }
}

// NuGet: Install-Package MuPDF.NET
using MuPDFCore;
using System.IO;

class Program
{
    static void Main()
    {
        // PDF格式 doesn't support HTML 轉 PDF conversion directly
        // You would need to use another library to convert HTML to a supported format first
        // This is a limitation - PDF格式 is primarily a PDF renderer/viewer

        // Alternative: Use a browser engine or intermediate conversion
        string html = "<html><body><h1>Hello World</h1></body></html>";

        // Not natively supported in MuPDF
        throw new NotSupportedException("MuPDF does not support direct HTML 轉 PDF conversion");
    }
}

$vbLabelText $csharpLabel

（IronPDF 之後）：

// NuGet: Install-Package IronPdf
using IronPdf;

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;

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");
    }
}

$vbLabelText $csharpLabel

這個例子凸顯了 PDF格式最主要的限制：它根本無法將 HTML 轉換為 PDF。 PDF格式程式碼明確拋出NotSupportedException ，因為 HTML 到 PDF 的轉換根本不是 PDF格式提供的功能。如果您需要使用 PDF格式實作此功能，則必須使用像 wkhtmltopdf 這樣的單獨庫或瀏覽器引擎，然後使用 PDF格式載入產生的 PDF 進行檢視。

IronPDF 的ChromePdfRenderer使用完整的 Chromium 引擎渲染 HTML，並完全支援 CSS3、JavaScript 和現代 Web 標準。 RenderHtmlAsPdf()方法直接接受 HTML 字串。有關 URL 渲染和 HTML 文件轉換等其他渲染選項，請參閱HTML 轉 PDF 文件。

範例 2：文字擷取

之前（PDF格式）：

// NuGet: Install-Package MuPDF.NET
using MuPDFCore;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        using (MuPDFDocument document = new MuPDFDocument("input.pdf"))
        {
            StringBuilder allText = new StringBuilder();

            for (int i = 0; i < document.Pages.Count; i++)
            {
                string pageText = document.Pages[i].GetText();
                allText.AppendLine(pageText);
            }

            Console.WriteLine(allText.ToString());
        }
    }
}

// NuGet: Install-Package MuPDF.NET
using MuPDFCore;
using System;
using System.Text;

class Program
{
    static void Main()
    {
        using (MuPDFDocument document = new MuPDFDocument("input.pdf"))
        {
            StringBuilder allText = new StringBuilder();

            for (int i = 0; i < document.Pages.Count; i++)
            {
                string pageText = document.Pages[i].GetText();
                allText.AppendLine(pageText);
            }

            Console.WriteLine(allText.ToString());
        }
    }
}

$vbLabelText $csharpLabel

（IronPDF 之後）：

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

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        string text = pdf.ExtractAllText();

        Console.WriteLine(text);
    }
}

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

class Program
{
    static void Main()
    {
        var pdf = PdfDocument.FromFile("input.pdf");
        string text = pdf.ExtractAllText();

        Console.WriteLine(text);
    }
}

$vbLabelText $csharpLabel

MuPDF 方法需要建立一個帶有MuPDFDocument using區塊，使用 for 迴圈手動遍歷document.Pages.Count ，對每一頁呼叫document.Pages[i].GetText() ，並使用StringBuilder建立文字。這是用於簡單文字提取的 12 行程式碼。

IronPDF 將此操作簡化為 3 行程式碼：使用PdfDocument.FromFile()載入文檔，呼叫ExtractAllText() ，並列印結果。對於這種簡單的操作，無需手動迭代，無需 StringBuilder，也無需using程式碼區塊進行明確資源管理。了解更多關於從PDF中提取文字的資訊。

範例 3：合併多個 PDF 文件

之前（PDF格式）：

// NuGet: Install-Package MuPDF.NET
using MuPDFCore;
using System.IO;

class Program
{
    static void Main()
    {
        using (MuPDFDocument doc1 = new MuPDFDocument("file1.pdf"))
        using (MuPDFDocument doc2 = new MuPDFDocument("file2.pdf"))
        {
            // Create a new document
            using (MuPDFDocument mergedDoc = MuPDFDocument.Create())
            {
                // Copy pages from first document
                for (int i = 0; i < doc1.Pages.Count; i++)
                {
                    mergedDoc.CopyPage(doc1, i);
                }

                // Copy pages from second document
                for (int i = 0; i < doc2.Pages.Count; i++)
                {
                    mergedDoc.CopyPage(doc2, i);
                }

                mergedDoc.Save("merged.pdf");
            }
        }
    }
}

// NuGet: Install-Package MuPDF.NET
using MuPDFCore;
using System.IO;

class Program
{
    static void Main()
    {
        using (MuPDFDocument doc1 = new MuPDFDocument("file1.pdf"))
        using (MuPDFDocument doc2 = new MuPDFDocument("file2.pdf"))
        {
            // Create a new document
            using (MuPDFDocument mergedDoc = MuPDFDocument.Create())
            {
                // Copy pages from first document
                for (int i = 0; i < doc1.Pages.Count; i++)
                {
                    mergedDoc.CopyPage(doc1, i);
                }

                // Copy pages from second document
                for (int i = 0; i < doc2.Pages.Count; i++)
                {
                    mergedDoc.CopyPage(doc2, i);
                }

                mergedDoc.Save("merged.pdf");
            }
        }
    }
}

$vbLabelText $csharpLabel

（IronPDF 之後）：

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("file1.pdf");
        var pdf2 = PdfDocument.FromFile("file2.pdf");

        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
    }
}

// NuGet: Install-Package IronPdf
using IronPdf;

class Program
{
    static void Main()
    {
        var pdf1 = PdfDocument.FromFile("file1.pdf");
        var pdf2 = PdfDocument.FromFile("file2.pdf");

        var merged = PdfDocument.Merge(pdf1, pdf2);
        merged.SaveAs("merged.pdf");
    }
}

$vbLabelText $csharpLabel

MuPDF合併操作尤其冗長。您必須在嵌套的using區塊中開啟兩個來源文檔，使用MuPDFDocument.Create()建立一個新的空文檔，遍歷第一個文檔的每一頁並調用CopyPage() ，遍歷第二個文檔的每一頁並調用CopyPage() ，最後儲存。那可是二十多行程式碼，而且嵌套結構很複雜。

IronPDF 的靜態方法PdfDocument.Merge()接受多個 PDF 文件並傳回一個合併後的文件。整個操作僅需 4 行易讀程式碼。若要合併多個文檔，您可以傳遞一個清單： PdfDocument.Merge(pdfList) 。如需更多選項，請參閱合併和拆分 PDF 文件。

關鍵遷移說明

移除本地二進位文件

MuPDF 需要平台特定的本機庫。遷移到 IronPDF 後，請刪除所有 PDF格式原生二進位檔案：

# Delete native libraries
rm -f mupdf*.dll libmupdf*.so libmupdf*.dylib

# Remove runtime folders
rm -rf runtimes/*/native/

# Update Docker files to remove PDF格式 installation

# Delete native libraries
rm -f mupdf*.dll libmupdf*.so libmupdf*.dylib

# Remove runtime folders
rm -rf runtimes/*/native/

# Update Docker files to remove PDF格式 installation

SHELL

IronPDF 是完全託管的 .NET 程式碼－無需跨平台管理原生二進位檔案。

處置模式簡化

MuPDF 需要明確的上下文和文件管理：

// MuPDF: Nested using blocks required
using (MuPDFDocument document = new MuPDFDocument("input.pdf"))
{
    // Work with document
}

// IronPDF: Simpler pattern
var pdf = PdfDocument.FromFile("input.pdf");
// Work with pdf

// MuPDF: Nested using blocks required
using (MuPDFDocument document = new MuPDFDocument("input.pdf"))
{
    // Work with document
}

// IronPDF: Simpler pattern
var pdf = PdfDocument.FromFile("input.pdf");
// Work with pdf

$vbLabelText $csharpLabel

頁面迭代模式變化

MuPDF 使用基於索引的迭代，並明確計算頁數：

// MuPDF
for (int i = 0; i < document.Pages.Count; i++)
{
    var pageText = document.Pages[i].GetText();
}

// IronPDF (foreach supported)
foreach (var page in pdf.Pages)
{
    var pageText = page.Text;
}

// MuPDF
for (int i = 0; i < document.Pages.Count; i++)
{
    var pageText = document.Pages[i].GetText();
}

// IronPDF (foreach supported)
foreach (var page in pdf.Pages)
{
    var pageText = page.Text;
}

$vbLabelText $csharpLabel

新增功能

遷移到 IronPDF 後，您將獲得 PDF格式無法提供的功能：

// PDF 建立 from HTML (not possible in MuPDF)
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello</h1>");

// Watermarks (not possible in MuPDF)
pdf.ApplyWatermark("<div style='color:red;opacity:0.3;'>DRAFT</div>");

// Password Protection (not possible in MuPDF)
pdf.SecuritySettings.OwnerPassword = "admin";
pdf.SecuritySettings.UserPassword = "user";

// Headers and Footers (not possible in MuPDF)
pdf.AddTextHeader("Document Title");
pdf.AddTextFooter("Page {page} of {total-pages}");

// PDF 建立 from HTML (not possible in MuPDF)
var pdf = renderer.RenderHtmlAsPdf("<h1>Hello</h1>");

// Watermarks (not possible in MuPDF)
pdf.ApplyWatermark("<div style='color:red;opacity:0.3;'>DRAFT</div>");

// Password Protection (not possible in MuPDF)
pdf.SecuritySettings.OwnerPassword = "admin";
pdf.SecuritySettings.UserPassword = "user";

// Headers and Footers (not possible in MuPDF)
pdf.AddTextHeader("Document Title");
pdf.AddTextFooter("Page {page} of {total-pages}");

$vbLabelText $csharpLabel

故障排除

問題 1：未找到 MuPDFDocument 文件

問題： IronPDF 中不存在MuPDFDocument類別。

解：使用PdfDocument.FromFile() :

// MuPDF
using (MuPDFDocument document = new MuPDFDocument("input.pdf"))

// IronPDF
var pdf = PdfDocument.FromFile("input.pdf");

// MuPDF
using (MuPDFDocument document = new MuPDFDocument("input.pdf"))

// IronPDF
var pdf = PdfDocument.FromFile("input.pdf");

$vbLabelText $csharpLabel

問題 2：未找到 Pages.Count

問題： document.Pages.Count模式不起作用。

解決方案：使用pdf.PageCount ：

// MuPDF
for (int i = 0; i < document.Pages.Count; i++)

// IronPDF
for (int i = 0; i < pdf.PageCount; i++)
// Or use: foreach (var page in pdf.Pages)

// MuPDF
for (int i = 0; i < document.Pages.Count; i++)

// IronPDF
for (int i = 0; i < pdf.PageCount; i++)
// Or use: foreach (var page in pdf.Pages)

$vbLabelText $csharpLabel

問題 3：未找到 GetText() 函數

問題： page.GetText()方法不存在。

解決方法：使用page.Text屬性或pdf.ExtractAllText() ：

// MuPDF
string pageText = document.Pages[i].GetText();

// IronPDF
string pageText = pdf.Pages[i].Text;
// Or for all text:
string allText = pdf.ExtractAllText();

// MuPDF
string pageText = document.Pages[i].GetText();

// IronPDF
string pageText = pdf.Pages[i].Text;
// Or for all text:
string allText = pdf.ExtractAllText();

$vbLabelText $csharpLabel

問題 4：找不到 CopyPage

問題：手動複製頁面以進行合併的模式。

解決方案：使用靜態的PdfDocument.Merge()方法：

// MuPDF
mergedDoc.CopyPage(doc1, i);

// IronPDF
var merged = PdfDocument.Merge(pdf1, pdf2);

// MuPDF
mergedDoc.CopyPage(doc1, i);

// IronPDF
var merged = PdfDocument.Merge(pdf1, pdf2);

$vbLabelText $csharpLabel

遷移清單

遷移前

清點程式碼庫中所有 PDF格式的使用情況
記錄所有渲染操作（DPI、縮放因子）
確定任何 PDF 創建需求（目前使用外部工具）
列出文字擷取要求
檢查部署腳本中的原生二進位檔案處理情況
取得 IronPDF 許可證密鑰

軟體包變更

刪除MuPDF.NET包
移除MuPDFCore軟體包
刪除MuPDFCore.MuPDFWrapper包安裝IronPdf NuGet 套件： dotnet add package IronPdf
更新命名空間匯入

程式碼更改

在啟動時新增許可證金鑰配置
將MuPDFDocument替換為PdfDocument.FromFile()
將document.Pages.Count替換為pdf.PageCount
將page.GetText()替換為page.Text或pdf.ExtractAllText()
將手動CopyPage循環替換為PdfDocument.Merge()
移除嵌套的using語句區塊以進行上下文管理
如有需要，請新增 PDF 建立程式碼（HTML 轉 PDF）

移民後

從專案中移除原生 PDF格式二進位文件
更新 Docker 檔案以移除 PDF格式安裝
刪除平台特定的運行時資料夾
執行迴歸測試，比較渲染輸出
在所有目標平台（Windows、Linux、macOS）上進行測試
考慮新增功能（浮水印、安全設定、頁首/頁尾）

Curtis Chau

立即與工程團隊聊天

技術撰稿人

Curtis Chau 擁有電腦科學學士學位（卡爾頓大學），專長於前端開發，精通 Node.js、TypeScript、JavaScript 和 React。Curtis 對製作直覺且美觀的使用者介面充滿熱情，他喜歡使用現代化的架構，並製作結構良好且視覺上吸引人的手冊。

除了開發之外，Curtis 對物聯網 (IoT) 也有濃厚的興趣，他喜歡探索整合硬體與軟體的創新方式。在空閒時間，他喜歡玩遊戲和建立 Discord bots，將他對技術的熱愛與創意結合。

發表日期 2026年2月1日

How to Migrate from ZetPDF to IronPDF in C#

Master the migration from ZetPDF to IronPDF with this complete C# guide. Switch from a coordinate-based library to a modern HTML-to-PDF solution. Includes code examples for HTML conversion, merging PDFs, and removing PDFSharp dependencies.

發表日期 2026年2月1日

How to Migrate from Scryber.Core to IronPDF in C#

Master the migration from Scryber.Core to IronPDF with this complete C# guide. Switch from custom XML/HTML parsing to a modern Chromium renderer. Includes code examples for HTML conversion, URL rendering, and replacing proprietary bindings.

發表日期 2026年2月1日

How to Migrate from XFINIUM.PDF to IronPDF in C#

Master the migration from XFINIUM.PDF to IronPDF with this complete C# guide. Switch from manual coordinate-based positioning to declarative HTML/CSS rendering. Includes code examples for replacing graphics primitives and automatic layout.

How to Migrate from MigraDoc to Iro...

開始 30 天免費試用

How to Migrate from MuPDF to IronPDF in C#

為什麼要從 PDF格式 遷移到 IronPDF

MuPDF挑戰賽

PDF格式 與 IronPDF 對比

遷移複雜度評估

各功能預計工作量

範式轉移

開始之前

先決條件

NuGet 套件變更

許可證配置

識別 PDF格式 使用情況

完整 API 參考

文件載入中

頁面訪問

文字擷取

PDF 建立（MuPDF 中不可用）

PDF 操作（MuPDF 中的限制）

程式碼遷移範例

範例 1：HTML 轉 PDF（MuPDF 無法完成此操作）

範例 2：文字擷取

範例 3：合併多個 PDF 文件

關鍵遷移說明

移除本地二進位文件

處置模式簡化

頁面迭代模式變化

新增功能

故障排除

問題 1：未找到 MuPDFDocument 文件

問題 2：未找到 Pages.Count

問題 3：未找到 GetText() 函數

問題 4：找不到 CopyPage

遷移清單

遷移前

軟體包變更

程式碼更改

移民後

相關文章

How to Migrate from ZetPDF to IronPDF in C#

How to Migrate from Scryber.Core to IronPDF in C#

How to Migrate from XFINIUM.PDF to IronPDF in C#

下一步：開始免費 30 天試用

下一步：開始免費 30 天試用

深受全球數百萬工程師信賴

為什麼要從 PDF格式遷移到 IronPDF

PDF格式與 IronPDF 對比

識別 PDF格式使用情況