IRONSOFTWAREHOME
IRONSUITE所有10個程式庫只需支付2個的價格
聯絡銷售
按公司
影片

從Tesseract移轉到IronOCR

Kannaopat Udonpant
Kannapat Udonpant
Updated: 2026年8月1日

此指南提供從 charlesw Tesseract NuGet 套件到IronOCR的直接遷移路徑。 它涵蓋了消除 tessdata 資料夾管理、取代 TesseractEngine 和 Pix 初始化模式、增加內建預處理管道以及解鎖原生 PDF 支援所需的特定步驟——不重複比較文章中已經檢查過的材料。

為什麼要從 Tesseract 遷移

charlesw Tesseract 套件展現了真正的 OCR 能力，其 800 萬個 NuGet 下載量證明了這一點。 問題不在引擎——而是在您必須在引擎周圍建立的基礎設施，在此之前您無法輸出產業級別的成品。 四個特定的痛點驅動著大多數遷移決策。

tessdata 資料夾管理隨著每個環境而加劇。在任何一個字詞可以被識别之前，tessdata 路徑必須存在，並已填充您應用程式所需的每種語言的正確 .traineddata 文件，並且能夠在傳遞給 TesseractEngine 的路徑上被存取。 這意味著開發機、CI 構建、暫存伺服器、生成主機和 Docker 容器的單獨資料夾設置。 缺少文件會在運行時引發 TesseractException: Failed to initialise tesseract engine ——在部署後——並伴隨一條並非總是顯示缺少哪個文件的資訊。 每新增一個環境就是此故障的另一次機會。

Tesseract 4.1.1 是終點。charlesw 包裝器固定在 2019 年發佈的 Tesseract 4.1.1 上。Tesseract 5.x 引入了 LSTM 模型改進，在某些文件型別上顯著提高了準確性。該版本無法通過此包獲得，自 2021 年以來，包裝器的維護節奏已經顯著放緩。關心與當前 Tesseract 發行版本準確性相當的團隊通過 charlesw 包裝器無法升級。

無預處理意味著對現實世界文件不可靠。Tesseract 期望乾淨、高解析度、正確對齊的輸入。 它不會針對傾斜、雜訊、低 DPI 或顏色背景進行內建校正。 手動建立預處理管道——灰度轉換、對比增強、二值化、中值雜訊濾波、去傾斜——需要使用 System.Drawing.Common（僅限 Windows）編寫大約 180 行程式碼，或者需要拉入 OpenCvSharp4 進行適當的 Hough 變換去傾斜。 該管道必須隨著新文件來源的加入而保持。

PDF 是一種附加功能，需要第二個依賴鏈。合約、發票、銀行結單和合規文件以 PDF 形式到達。 Tesseract無法開啟PDF。 跨越差距需要單獨的 PDF 渲染庫——PdfiumViewer、PDFtoImage 或 Docnet.Core——每個都有自己的原生二進制文件、特定於平台的部署步驟和許可考量。 GhostScript 引入 AGPL 許可的影響。 密碼保護 PDF 需要再增添一個庫。 管理三個不同的原生依賴鏈跨多個環境的團隊會達到一個維護門檻，這促使直接評估單一包裝替代方案。

非執行緒安全引擎設計限制並行吞吐量。TesseractEngine實例不能跨執行緒共享。 標準的並行處理模式為每個執行緒建立一個引擎，每個實例載入 40-100 MB 的語言模型資料。 八個並行執行緒意味著在處理任何文件之前引擎初始化開銷為 320-800 MB。 這不是一個 bug——它是非執行緒安全 API 的預期用法——但記憶體成本是真實的，並且隨著批次的增長而複合。

根本問題

每個 Tesseract 應用程式的啟動方式都是一樣的：指定一個 tessdata 路徑，該路徑必須在應用程式運行的每台機器上都是正確的。

Tesseract 方法：

// TessDataPath must exist and be populated — breaks on first clean deployment
private const string TessDataPath = @"./tessdata";

public static string ExtractText(string imagePath)
{
    // Runtime failure if eng.traineddata is missing from TessDataPath
    if (!Directory.Exists(TessDataPath))
        throw new DirectoryNotFoundException(
            $"Tessdata not found at {TessDataPath}. " +
            "Download from https://github.com/tesseract-ocr/tessdata");

    using var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default);
    using var img   = Pix.LoadFromFile(imagePath);  // Leptonica Pix object
    using var page  = engine.Process(img);
    return page.GetText();
}

IronOCR方法：

// No tessdata folder. No path. No file check. Just OCR.
var text = new IronTesseract().Read("document.jpg").Text;

整個 TessDataPath 常量、Directory.Exists 保護、Pix 物件和三層 using 巢狀消失。 語言資料嵌入在 NuGet 包中。

##IronOCR與 Tesseract：功能比較

下表涵蓋了在遷移決策中最重要的功能。

功能Tesseract（charlesw）IronOCR
NuGet套件TesseractIronOcr
Tesseract引擎版本4.1.1（2019，固定）優化的 Tesseract 5.x
Tessdata管理手動資料夾 + 文件下載捆綁——零配置
語言包手動 .traineddata 下載每種語言一個 NuGet 套件
可用語言100+（手動）125+（NuGet）
多語言同時支援"eng+fra+deu" 字串OcrLanguage.French + OcrLanguage.German
圖像預處理手動（約 180 行）內建單行方法
去傾斜手動（需要 Hough 變換）input.Deskew()
去雜訊手動（中值濾波）input.DeNoise()
對比 / 二值化手動像素迭代input.Contrast(), input.Binarize()
深度降噪不可用input.DeepCleanBackgroundNoise()
PDF輸入無——需要外部程式庫原生（掃描、數位、混合）
受密碼保護的 PDF需要解密程式庫input.LoadPdf(path, Password: "...")
多頁TIFF手動框架迭代input.LoadImageFrames()
可搜尋的PDF輸出不支持result.SaveAsSearchablePdf()
結構化結果存取ResultIterator 迴圈result.Pages, .Paragraphs, .Words
執行緒安全非執行緒安全執行緒安全單一實例
條碼識別不支持ocr.Configuration.ReadBarCodes = true
跨平台每個平台需要原生 DLLs單一NuGet，所有平台
Docker部署apt-get + tessdata COPY 步驟不需額外步驟
授權Apache 2.0（免費）永久（$999 Lite / $1,499 Pro / $2,999 Enterprise）
商業支持僅限社區是（電子郵件 + 優先順序別）

快速開始：從 Tesseract 遷移到 IronOCR

步驟1：替換NuGet包

移除 charlesw Tesseract 包裝器：

dotnet remove package Tesseract
SHELL

從NuGet安裝IronOCR：

> dotnet add package IronOcr

當需要時，語言包作為單獨套件安裝：

> dotnet add package IronOcr.Languages.French, IronOcr.Languages.German

步驟2：更新命名空間

用IronOCR命名空間取代 Tesseract 命名空間：

// Before
using Tesseract;

// After
using IronOcr;

步驟3：初始化許可證

在任何 IronTesseract 呼叫之前，在應用程式啟動時新增許可初始化：

IronOcr.License.LicenseKey = "YOUR-LICENSE-KEY";

在開發期間，免費試用版可以在無金鑰的情況下運行。 生產部署需要從授權頁面獲得有效金鑰。

程式碼遷移範例

Tessdata 路徑消除和引擎初始化

最直接的改變是移除 TesseractEngine 初始化和環繞其周圍的所有 tessdata 驗證程式碼。

Tesseract 方法：

// Every class that uses OCR must handle this initialization block
private const string TessDataPath = @"./tessdata";

public string RecognizeInvoiceNumber(string imagePath)
{
    // Check tessdata presence — missing file = silent runtime failure
    foreach (var lang in new[] { "eng" })
    {
        if (!File.Exists(Path.Combine(TessDataPath, $"{lang}.traineddata")))
            throw new FileNotFoundException(
                $"Missing {lang}.traineddata. " +
                "Download from https://github.com/tesseract-ocr/tessdata");
    }

    using var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default);

    // Pix is a Leptonica wrapper type — not a standard .NET image
    using var img  = Pix.LoadFromFile(imagePath);
    using var page = engine.Process(img);

    string text = page.GetText();
    float  conf = page.GetMeanConfidence();

    return conf > 0.7f ? text : string.Empty;
}

IronOCR方法：

using IronOcr;

public string RecognizeInvoiceNumber(string imagePath)
{
    var result = new IronTesseract().Read(imagePath);

    // Confidence property returns 0-100 double
    return result.Confidence > 70 ? result.Text : string.Empty;
}

FileNotFoundException 保護、tessdata 常量、Pix 物件和三層巢狀已消失。 IronTesseract 沒有參數構造，因為語言資料是嵌入的。 當您需要非預設行為時，請參見 IronTesseract 設定指南，以及完整信心水準 API 的 信心水準指南。

多頁 TIFF 處理與預處理管道

多幀 TIFF 文件——在掃描文件檔案和傳真系統中常見——需要 Tesseract 明確的幀迭代。IronOCR在一個呼叫中載入所有幀，並統一應用預處理管道。

Tesseract 方法：

using Tesseract;
using System.Drawing;
using System.Drawing.Imaging;

private const string TessDataPath = @"./tessdata";

public static string ExtractFromMultiPageTiff(string tiffPath)
{
    var allText = new System.Text.StringBuilder();

    using var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default);
    using var tiffImage = Image.FromFile(tiffPath);

    int frameCount = tiffImage.GetFrameCount(FrameDimension.Page);

    for (int i = 0; i < frameCount; i++)
    {
        tiffImage.SelectActiveFrame(FrameDimension.Page, i);

        // Must save each frame to disk — Pix.LoadFromFile requires a path
        string tempPath = Path.GetTempFileName() + ".png";
        try
        {
            tiffImage.Save(tempPath, ImageFormat.Png);

            using var img  = Pix.LoadFromFile(tempPath);
            using var page = engine.Process(img);
            allText.AppendLine(page.GetText());
        }
        finally
        {
            File.Delete(tempPath); // Uncleaned temp files fill disk on failure
        }
    }

    return allText.ToString();
}

IronOCR方法：

using IronOcr;

public static string ExtractFromMultiPageTiff(string tiffPath)
{
    using var input = new OcrInput();
    input.LoadImageFrames(tiffPath);  // Loads all frames at once
    input.Deskew();                   // Applied to every frame uniformly
    input.DeNoise();

    var result = new IronTesseract().Read(input);
    return result.Text;
}

無需幀迭代。 不建立臨時文件。 無清理邏輯。 預處理管道應用於每個幀，無需額外的迴圈。TIFF 和 GIF 輸入指南詳細介紹多幀處理，包括大型檔案的選擇性幀範圍。

可搜尋PDF生成

將掃描 PDF 轉換為可搜尋 PDF，需要 Tesseract 將每個頁面渲染為圖像（通過外部 PDF 庫），運行 OCR，然後重新構建帶文字層的 PDF——這是一個多庫、多步驟的過程。IronOCR在一個管道中處理輸入、OCR 和輸出。

Tesseract 方法：

// Requires: PdfiumViewer + Tesseract + a PDF writer library (iText, PdfSharp)
// Each library adds its own native dependencies and license considerations

using Tesseract;
// using PdfiumViewer;  // Comment: must add NuGet + deploy native pdfium.dll
// using iText.Kernel.Pdf;  // Comment: AGPL or commercial license required

private const string TessDataPath = @"./tessdata";

public static void CreateSearchablePdf(string inputPdfPath, string outputPdfPath)
{
    // Step 1: Render PDF pages to images (requires PdfiumViewer)
    // Step 2: Run OCR on each image (Tesseract)
    // Step 3: Write text positions back into PDF (requires iText or PDFsharp)
    //
    // Total: ~150 lines across three libraries
    // Native binaries required: tesseract*.dll, leptonica*.dll, pdfium.dll
    // License risk: iText is AGPL unless you purchase a commercial license

    throw new NotImplementedException(
        "Requires PdfiumViewer + Tesseract + a PDF writer. " +
        "No single-package solution exists with this stack.");
}

IronOCR方法：

using IronOcr;

public static void CreateSearchablePdf(string inputPdfPath, string outputPdfPath)
{
    using var input = new OcrInput();
    input.LoadPdf(inputPdfPath);
    input.Deskew();    // Correct scanned page skew before OCR
    input.DeNoise();   // Remove scanner artifacts

    var result = new IronTesseract().Read(input);
    result.SaveAsSearchablePdf(outputPdfPath);
}

一個方法調用即可生成帶內嵌文字層的可搜尋 PDF。 無需外部 PDF 庫、無原生 pdfium 二進制、無需與 AGPL 依賴項結合的許可。 可搜尋 PDF 指南記錄了輸出格式，PDF OCR 範例展示了完整的掃描文件管道。為了給IronOCR的 PDF 輸入提供更廣泛的背景，PDF OCR 用例頁面涵蓋了生產架構模式。

從掃描文件中提取結構化資料

Tesseract 通過 ResultIterator 暴露字詞層級資料，這需要使用 do/while 迴圈手動提取邊界框。IronOCR以強型別集合形態暴露文件層次結構——頁面、段落、行、字詞——座標已經填充。

Tesseract 方法：

using Tesseract;

private const string TessDataPath = @"./tessdata";

public static void ExtractStructuredData(string imagePath)
{
    using var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default);
    using var img    = Pix.LoadFromFile(imagePath);
    using var page   = engine.Process(img);
    using var iter   = page.GetIterator();

    iter.Begin();
    do
    {
        if (iter.IsAtBeginningOf(PageIteratorLevel.Para))
            Console.WriteLine("-- New Paragraph --");

        if (iter.TryGetBoundingBox(PageIteratorLevel.Word, out var bounds))
        {
            string word       = iter.GetText(PageIteratorLevel.Word);
            float  confidence = iter.GetConfidence(PageIteratorLevel.Word);
            Console.WriteLine(
                $"Word: '{word?.Trim()}' " +
                $"at ({bounds.X1},{bounds.Y1})-({bounds.X2},{bounds.Y2}) " +
                $"conf={confidence:P0}");
        }
    }
    while (iter.Next(PageIteratorLevel.Word));
}

IronOCR方法：

using IronOcr;

public static void ExtractStructuredData(string imagePath)
{
    var result = new IronTesseract().Read(imagePath);

    foreach (var page in result.Pages)
    {
        Console.WriteLine($"Page {page.PageNumber} — confidence: {result.Confidence}%");

        foreach (var paragraph in page.Paragraphs)
        {
            Console.WriteLine($"  Paragraph at ({paragraph.X},{paragraph.Y}):");
            Console.WriteLine($"  {paragraph.Text}");

            foreach (var word in paragraph.Words)
            {
                Console.WriteLine(
                    $"    Word: '{word.Text}' " +
                    $"at ({word.X},{word.Y}) " +
                    $"size {word.Width}x{word.Height} " +
                    $"conf={word.Confidence:P0}");
            }
        }
    }
}

ResultIterator 迴圈完全消失。 文件階層是一組可枚舉的集合——無迭代器狀態、無手動級別跟蹤、無輸出參數的邊界框提取。 每個字詞物件攜帶其自己的座標和確信度。 讀取結果指南記錄了階層的每一級，OcrResult API 參考列出了所有可用屬性。

無需 tessdata 文件管理的多語言 OCR

新增語言到 Tesseract 應用程式中意味着要下載 .traineddata 文件，將其放在 tessdata 資料夾中，更新包含該資料夾的每個部署清單，並修改引擎初始化字串。 對於 IronOCR，這只需一個 NuGet 包引用。

Tesseract 方法：

using Tesseract;

private const string TessDataPath = @"./tessdata";

public static string ExtractFromEuropeanDocument(string imagePath)
{
    // Before this call works, these files must exist:
    // ./tessdata/eng.traineddata  (~15 MB, from GitHub)
    // ./tessdata/fra.traineddata  (~15 MB, from GitHub)
    // ./tessdata/deu.traineddata  (~15 MB, from GitHub)
    // ./tessdata/spa.traineddata  (~15 MB, from GitHub)
    // Total: ~60 MB to download, version-match, and deploy to every environment

    foreach (var lang in new[] { "eng", "fra", "deu", "spa" })
    {
        if (!File.Exists(Path.Combine(TessDataPath, $"{lang}.traineddata")))
            throw new FileNotFoundException(
                $"Download {lang}.traineddata from " +
                "https://github.com/tesseract-ocr/tessdata " +
                $"and place in {TessDataPath}");
    }

    // Language string is a concatenation — order affects recognition priority
    using var engine = new TesseractEngine(TessDataPath, "eng+fra+deu+spa", EngineMode.Default);
    using var img    = Pix.LoadFromFile(imagePath);
    using var page   = engine.Process(img);
    return page.GetText();
}

IronOCR方法：

// Install language packs once per project:
// dotnet add package IronOcr.Languages.French
// dotnet add package IronOcr.Languages.German
// dotnet add package IronOcr.Languages.Spanish
using IronOcr;

public static string ExtractFromEuropeanDocument(string imagePath)
{
    var ocr = new IronTesseract();
    ocr.Language = OcrLanguage.English;
    ocr.AddSecondaryLanguage(OcrLanguage.French);
    ocr.AddSecondaryLanguage(OcrLanguage.German);
    ocr.AddSecondaryLanguage(OcrLanguage.Spanish);

    return ocr.Read(imagePath).Text;
}

tessdata 資料夾、文件存在迴圈、路徑串接字串和部署清單更新都被 PackageReference 行取代於 .csproj。 在 Docker 中增加語言意味著一個額外的 dotnet add package，而不是 Dockerfile COPY 步驟。多語言指南涵蓋完整的 125+ 語言目錄和 CJK 字字元集，語言索引列出每個可用的語言包。

Tesseract API 到IronOCR映射參考

Tesseract（charlesw）IronOCR
new TesseractEngine(tessDataPath, "eng", EngineMode.Default)new IronTesseract()
Pix.LoadFromFile(path)input.LoadImage(path) 或 ocr.Read(path)
Pix.LoadFromMemory(bytes)input.LoadImage(bytes)
engine.Process(img)ocr.Read(input)
page.GetText()result.Text
page.GetMeanConfidence()result.Confidence
page.GetHOCRText(0)result.SaveAsHocrFile(path)
engine.Process(img, tessRect)input.LoadImage(path, new CropRectangle(x, y, w, h))
page.GetIterator()result.Pages / result.Paragraphs / result.Words
iter.GetText(PageIteratorLevel.Word)result.Words[i].Text
iter.GetConfidence(PageIteratorLevel.Word)result.Words[i].Confidence
iter.TryGetBoundingBox(PageIteratorLevel.Word, out bounds)word.X, word.Y, word.Width, word.Height
"eng+fra+deu" 語言字串ocr.AddSecondaryLanguage(OcrLanguage.French)
Tessdata 資料夾 + .traineddata 文件NuGet 語言包（IronOcr.Languages.French）
不適用——需要PdfiumViewer或類似input.LoadPdf(path)
N/A - 需要解密庫input.LoadPdf(path, Password: "secret")
N/A - 需要 iText 或 PDFSharpresult.SaveAsSearchablePdf(outputPath)
N/A - 手動 System.Drawing 管道input.Deskew(), input.DeNoise(), input.Binarize()
N/A - 每個執行緒具有引擎 Parallel.ForEach單一 IronTesseract 跨越所有執行緒共享
不支持ocr.Configuration.ReadBarCodes = true

常見的遷移問題与解決方案

問題 1：Tessdata 路徑參考在遷移後仍然存在

Tesseract：TessDataPath 常量、Directory.Exists(TessDataPath) 保護和 File.Exists(Path.Combine(TessDataPath, lang + ".traineddata")) 檢查出現在整個程式碼庫中和項目文件中作為 <Content Include="tessdata\**"> 建設項目。

解決方案：搜索所有出現並將其與 tessdata 資料夾一起刪除：

# Find all tessdata references in source
grep -r "TessDataPath\|tessdata\|traineddata" --include="*.cs" .
grep -r "tessdata" --include="*.csproj" .
SHELL

刪除路徑常量和文件保護後，從項目中刪除 tessdata 資料夾。 從 <Content Include="tessdata\**" CopyToOutputDirectory="..." /> 文件中移除任何 .csproj 行。 Dockerfile COPY ./tessdata 行和 ENV TESSDATA_PREFIX 環境變數聲明也可以安全地刪除。

問題 2：Pix Object 型別無法解析

Tesseract： Pix 是來自 Tesseract 命名空間的 Leptonica 圖像包裝器型別。 引用出現在變數宣告（using var img = Pix.LoadFromFile(...)）、Method 簽名接受 Pix 參數以及任何調用 Pix.LoadFromMemory() 或 Pix.LoadFromBitmap() 的程式碼中。

解決方案：用 input.LoadImage(path) 取代 Pix.LoadFromFile(path) 於 OcrInput 實例上。 用 input.LoadImage(bytes) 取代 Pix.LoadFromMemory(bytes)。 OcrInput 類接受文件路徑、字節陣列、流和 System.Drawing.Bitmap 物件直接。 不需要轉換到中間包裝器型別。 參見圖像輸入指南和流輸入指南，了解完整的接受輸入型別集合。

問題 3：ResultIterator 迴圈模式無直接對應

Tesseract：標準提取字級或字元級的模式程式碼為 ResultIterator 中的 iter.TryGetBoundingBox() 進行迭代。 此模式需要手動跟蹤迭代器狀態和層級轉換。

解決方案：用 result.Pages（或適當的集合層次）上的 LINQ 替換迭代器迴圈：

// Before: iterator loop
using var iter = page.GetIterator();
iter.Begin();
do
{
    if (iter.TryGetBoundingBox(PageIteratorLevel.Word, out var bounds))
    {
        string text = iter.GetText(PageIteratorLevel.Word);
        // process text and bounds
    }
}
while (iter.Next(PageIteratorLevel.Word));

// After: enumerable collection
var result = new IronTesseract().Read(imagePath);
foreach (var word in result.Words)
{
    // word.Text, word.X, word.Y, word.Width, word.Height, word.Confidence
}

對於段落級存取——在 Tesseract 迭代器中沒有乾淨類比——使用 result.Pages[i].Paragraphs。 讀取結果指南記錄了所有可用層級。

問題 4：PDF 庫程式碼必須完全刪除

Tesseract：任何將 PDF 頁面轉換為圖像然後傳給 Tesseract 的程式碼——包括 PdfiumViewer document.Render() 迴圈、PDFtoImage Conversion.ToImage() 呼叫、Docnet.Core GetPageReader() 模式或 GhostScript 過程調用——僅用於解決 Tesseract 無法打開 PDF 文件的問題。 這些類、迴圈、臨時文件模式和原生二進制部署都圍繞著真正的需求建立起來。

解決方案：完全刪除 PDF 渲染程式碼。 用 input.LoadPdf(path) 替換整個渲染-然後-OCR 塊：

// Before: ~50-150 lines of PdfiumViewer + Tesseract + temp file management
// After:
using var input = new OcrInput();
input.LoadPdf("document.pdf");
input.Deskew();
input.DeNoise();
var result = new IronTesseract().Read(input);

從 .csproj 中刪除 PdfiumViewer、PDFtoImage 和 Docnet.Core 套件引用。 從構建腳本和 Dockerfiles 中移除原生二進制部署（pdfium.dll、GhostScript 可執行文件）。 PDF輸入指南涵蓋頁面範圍選擇和受密碼保護的PDF。

問題 5：每執行緒引擎的並行處理模式

Tesseract：因單個引擎不是執行緒安全，安全的並行 OCR 標準模式在迴圈主體內建立一個新的 TesseractEngine。 這會載入每個執行緒的完整語言模型。

解決方案：在迴圈前建立 IronTesseract 並在內部引用：

// Before: engine per thread, 40-100 MB per language model, times thread count
Parallel.ForEach(files, file =>
{
    using var engine = new TesseractEngine(TessDataPath, "eng", EngineMode.Default);
    using var img    = Pix.LoadFromFile(file);
    using var page   = engine.Process(img);
    results[file] = page.GetText();
});

// After: single engine, thread-safe, shared pool
var ocr = new IronTesseract();
Parallel.ForEach(files, file =>
{
    var result = ocr.Read(file);
    results[file] = result.Text;
});

執行緒安全變化還消除了 using 清理模式從迴圈主體中，這僅用於確保每個執行緒的引擎即時釋放。

問題 6：EngineMode Enum 無直接對應

Tesseract：EngineMode.LstmOnly 出現在 TesseractEngine 構造函式中，以選擇 Tesseract 是否使用遺留引擎、LSTM 或兩者。 charlesw 包裝器暴露這些模式，因為 Tesseract 4.x 保留了兩個引擎。

解決方案：IronOCR 專門使用 Tesseract 5 LSTM 引擎，這是高精度配置。 因無遺留引擎可退回，不存在 EngineMode 參數。 在翻譯構造調用時，刪除 EngineMode 參數。 針對吞吐量與精度的調整，使用 ocr.Configuration.PageSegmentationMode 並參見速度優化指南。

Tesseract 遷移清單

遷移前

稽核程式碼庫中所有 Tesseract 和 tessdata 參考：

# Find all using directives for the Tesseract namespace
grep -rn "using Tesseract" --include="*.cs" .

# Find TesseractEngine constructors
grep -rn "TesseractEngine\|TessDataPath\|tessdata" --include="*.cs" .

# Find Pix object usage
grep -rn "Pix\." --include="*.cs" .

# Find ResultIterator usage
grep -rn "GetIterator\|ResultIterator\|PageIteratorLevel" --include="*.cs" .

# Find PDF rendering libraries added for Tesseract
grep -rn "PdfiumViewer\|PDFtoImage\|Docnet\|GhostScript" --include="*.cs" .

# Find tessdata references in project files
grep -rn "tessdata\|traineddata" --include="*.csproj" .

# Find tessdata references in Dockerfiles
grep -rn "tessdata\|TESSDATA_PREFIX\|libtesseract" Dockerfile* .
SHELL

清點結果以估算遷移範圍：

  • 計算有using Tesseract 的文件數，以確定多少類需要更改
  • 識別正在使用哪個 PDF 渲染庫（PdfiumViewer、PDFtoImage、Docnet.Core、GhostScript）
  • 記錄 TesseractEngine 構造函式字串中引用了哪些語言，以確定要新增哪些IronOCR語言 NuGet 套件

程式碼遷移

  1. 從所有 .csproj 文件中移除 Tesseract NuGet 套件引用
  2. 移除僅為支援 Tesseract 而新增的 PDF 渲染庫 NuGet 引用（PdfiumViewer、PDFtoImage、Docnet.Core）
  3. 安裝 IronOcr NuGet 套件
  4. 安裝所需語言 NuGet 套件（IronOcr.Languages.French 等）
  5. 在應用啟動時新增 IronOcr.License.LicenseKey = "YOUR-KEY";
  6. 在所有受影響的文件中用 using IronOcr; 替換 using Tesseract;
  7. 移除 TessDataPath 常量和所有 Directory.Exists / File.Exists tessdata 保護
  8. 用 new IronTesseract() 替換 new TesseractEngine(...)
  9. 用 input.LoadImage(path) 替換 Pix.LoadFromFile(path) 在 OcrInput 實例上
  10. 用 input.LoadImage(bytes) 替換 Pix.LoadFromMemory(bytes)
  11. 用 ocr.Read(input) 替換 engine.Process(img)
  12. 用 result.Text 替換 page.GetText()
  13. 用 result.Confidence 替換 page.GetMeanConfidence()
  14. 用 result.Words 或 result.Pages[i].Paragraphs 或枚舉替換 ResultIterator 迴圈
  15. 用 input.LoadPdf(path) 替換 PDF 渲染迴圈——完整刪除渲染庫程式碼
  16. 用 ocr.AddSecondaryLanguage(OcrLanguage.X) 呼叫替換 "eng+fra+deu" 語言字串
  17. 刪除 tessdata 資料夾及其建設 <Content Include="..."> 項目
  18. 從構建腳本和 Dockerfiles 中移除原生二進制部署步驟（tessdata COPY、TESSDATA_PREFIX ENV、apt-get libtesseract-dev）

遷移後

  • 驗證在開發期間使用 Tesseract 包裝器的相同範例圖像上的基本文字提取
  • 確認信心水準合理（對於乾淨的文件 70%+，對於高質量掃描 85%+）
  • 測試多頁 TIFF 輸入是否在 result.Pages 中生成正確的頁數
  • 確認 PDF 輸入讀取掃描的 PDF 文件而無需使用 PdfiumViewer 或任何外部庫
  • 使用 input.LoadPdf(path, Password: "...") 測試帶密碼保護的 PDF 讀取對已知加密文件
  • 確認可搜尋的 PDF 輸出能在 Adobe Reader 中打開並支持文字搜索
  • 測試並行處理：在 Parallel.ForEach 迴圈之前建立 IronTesseract 實例，確認沒有執行緒安全異常
  • 驗證每個語言包對目標語言文件集產生正確輸出
  • 在沒有 COPY tessdata 和 apt-get libtesseract-dev 的情況下運行 Docker 構建——確認容器啟動並處理文件
  • 確認 tessdata 資料夾和原生 DLL 文件在打包輸出目錄中均不存在
  • 驗證在移除原生二進制引用後，日誌中沒有 TesseractException 或 System.DllNotFoundException 出現

遷移至IronOCR的主要好處

部署縮減為單一包。tessdata 資料夾、特定於平台的原生庫（libtesseract.so.5）和任何 PDF 渲染原生二進制已從部署構件中移除。 新增環境——Linux 容器、一個 AWS Lambda 函式、一台 macOS 開發者機器——無需特定於平台的設置步驟。 Docker 部署指南和Linux 部署指南確認過程：安裝套件、新增許可金鑰、運行。 沒有 apt-get，沒有 COPY，沒有環境變數。

語言新增只需數秒，而非數分鐘。新增西班牙語 OCR 支援從 "下載 spa.traineddata，放置在 tessdata 資料夾，更新部署清單，驗證引擎構造中的路徑" 變為 dotnet add package IronOcr.Languages.Spanish 及 ocr.AddSecondaryLanguage(OcrLanguage.Spanish)。 相同的兩個步驟適用於每個平臺。 支持 10+ 語言的團隊——在跨國文件處理工作流程中常用——從數小時的持續維護壓縮為數分鐘的一次設置。瀏覽全目錄請參見語言索引。

PDF 工作流程無需外部庫。 部署和維護 PdfiumViewer 原生二進制文件、管理 pdfium.dll 寬度型別的 32/64 位環境、處理 GhostScript 的 AGPL 許可考量以及逐頁渲染迴圈的要求消失。 input.LoadPdf() 原生讀取掃描的 PDF、數位 PDF、混合內容 PDF 和密碼保護 PDF。 result.SaveAsSearchablePdf() 生成可搜尋的輸出而不涉及任何次要庫。 完整的回程——載入掃描 PDF、去傾斜和去噪、OCR、儲存可搜尋輸出——在 10 行程式碼以內。 參見可搜尋 PDF 部落格文章中的生產管道模式。

預處理是內建的，不需要您構建。大約 180 行手動預處理程式碼——色彩矩陣灰度、像素迭代對比度增強、中值濾波器去噪、Hough-變換去傾斜、DPI 縮放——成為一系列單行方法調用：input.Deskew(), input.DeNoise(), input.Contrast(), input.Binarize()。 對於大多數現實世界的文件，預設閱讀運用智能自動預處理而完全不需明確的濾波器調用。 圖像質量校正指南和圖像濾波器教程涵蓋全濾波器目錄。

Tesseract 5 準確性即時可用。charlesw 包裝器固定在 Tesseract 4.1.1。IronOCR 釋出經優化的 Tesseract 5 LSTM 引擎，您無需採取任何行動。 在困難文件型別上測量準確性下降的團隊——低 DPI 掃描、傳真、手印表單——一旦切換包裝即享 Tesseract 5 改進。 準確性差異最明顯的是 LSTM 識別超過遺留引擎的多數現實世界 OCR 工作負載的文件。

商業支援取代社群故障排除。charlesw 包裝器是一個由社群維護的開源項目，沒有保證的響應時間和 SLA。IronOCR提供電子郵件支援、更高級別的優先支援，和定期更新 .NET 相容性的商業維護程式碼庫。 對於生產 SLA 需要文件處理管道的團隊，這種支援模式很重要。 IronOCR 產品頁面和文件中心涵蓋完整功能和部署選項。

[[i：(Ghostscript、PDFium、PDFSharp、Tesseract和iText是其各自所有者的註冊商標。 此網站與Artifex Software、Chromium Project、Google、empira Software GmbH或iText Group無關聯、無認可或無贊助。所有產品名稱、標誌和品牌均屬於其各自所有者。 比較僅供資訊用途，並反映撰寫時獲得的公開資訊。)]]

Kannaopat Udonpant
Kannapat Udonpant
軟體工程師

相關文章

Key in blue circle

立即免費取得 30 天試用金鑰。

Your trial license will be sent to your email address

無任何限制。100% 解鎖。無需信用卡。

bullet_checked無需信用卡或建立帳號無任何限制。100% 解鎖。無需信用卡。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronOCR
預訂您的免費線上演示
Booking Badge

受到全球數百萬工程師的信任

Iron Software的客戶標誌
獲取您的無義務咨詢
您的詳細資訊將始終保密。
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
受到全球數百萬工程師的信任
立即獲取您的30天試用金鑰。
無需信用卡或帳戶建立
C# PDF的NuGet程式庫
使用NuGet安裝

版本： 2026.10

PM > Install-Package IronOcr
nuget.org/packages/IronOcr/
  1. 在解決方案資源管理器中，右鍵點擊參考，管理NuGet包
  2. 選擇瀏覽並搜尋"IronOCR"
  3. 選擇包並安裝
C# PDF DLL
下載 DLL

版本： 2026.10

或這裡下載Windows安裝程式。

  1. 下載並解壓IronOCR至您的方案目錄下的~/Libs等位置
  2. 在Visual Studio解決方案資源管理器中，右鍵點擊參考。選擇瀏覽，"IronOCR.dll"

授權從$999