Tesseract C# 与IronOCR：在.NET中应该使用哪个 OCR 库？

在 Visual Studio 中安装 Tesseract

PM> Install-Package TesseractOCR

PM> Install-Package TesseractOCR

PM> Install-Package TesseractOCR

安装完成后，从GitHub上的 tessdata 存储库下载相应的训练数据，并在您的.NET项目中配置文件。 tessdata 文件夹必须在运行时可访问，通常需要设置此文件夹的完整路径，或者将其与可执行文件一起放在输出目录中。 .NET wrapper 和语言文件之间的版本不匹配经常会导致初始化失败，这也是开发人员在 Stack Overflow 讨论中经常感到沮丧的原因。

此外，本地 Tesseract 二进制文件需要在运行应用程序的任何机器上安装 Visual C++ Redistributable。 这种依赖关系可能会使部署变得复杂，尤其是在容器化环境或客户端机器上，因为管理安装可能并不简单。

安装IronOCR

PM> Install-Package IronOcr

PM> Install-Package IronOcr

PM> Install-Package IronOcr

IronOCR 将所有内容捆绑到一个可管理的 .NET 包中，从而消除了配置的复杂性。 没有 C++ 运行时，没有测试数据文件夹管理，没有特定平台的本地 DLL 需要跟踪。 语言包会在需要时作为单独的NuGet包安装，并与标准的.NET依赖项管理集成。 Iron Software专门为需要 OCR 功能但又不想承担基础架构负担的.NET开发人员设计了这种方法。 了解更多关于IronOCR入门的信息。

Tesseract 文本提取示例

下面是使用 Tesseract 引擎的图像处理工作流程。这段代码演示了从 PNG 文件中提取文本的基本 OCR：

using TesseractOCR;
using TesseractOCR.Enums;
// Initialize the engine with tessdata path and language
using var engine = new Engine(@"./tessdata", Language.English, EngineMode.Default);
// Load input image using Pix format
using var img = Pix.LoadFromFile("document.png");
// Process the image and create a page
using var page = engine.Process(img);
// Extract plain text from recognized text
Console.WriteLine(page.GetText());

using TesseractOCR;
using TesseractOCR.Enums;
// Initialize the engine with tessdata path and language
using var engine = new Engine(@"./tessdata", Language.English, EngineMode.Default);
// Load input image using Pix format
using var img = Pix.LoadFromFile("document.png");
// Process the image and create a page
using var page = engine.Process(img);
// Extract plain text from recognized text
Console.WriteLine(page.GetText());

Imports TesseractOCR
Imports TesseractOCR.Enums

' Initialize the engine with tessdata path and language
Using engine As New Engine("./tessdata", Language.English, EngineMode.Default)
    ' Load input image using Pix format
    Using img As Pix = Pix.LoadFromFile("document.png")
        ' Process the image and create a page
        Using page As Page = engine.Process(img)
            ' Extract plain text from recognized text
            Console.WriteLine(page.GetText())
        End Using
    End Using
End Using

这种方法需要管理 tessdata 文件夹路径，确保适当的文件权限，并处理 Tesseract 引擎所期望的 Pix 图像格式。如果训练数据文件丢失或不兼容，引擎初始化会产生异常。 由于必须正确处理本地 Tesseract 资源，防止未托管代码泄漏，因此需要仔细关注内存使用情况。 对于遇到初始化问题的开发人员， IronOCR故障排除指南解释了常见的 Tesseract 挑战和解决方案。

IronOCR文本提取示例

以下代码展示了IronOCR如何简化相同的文本提取任务：

using IronOcr;
// Initialize the OCR engine
var ocr = new IronTesseract();
// Load and process the input image
using var input = new OcrInput();
input.LoadImage("document.png");
// Read text with automatic optimization
var result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
// Initialize the OCR engine
var ocr = new IronTesseract();
// Load and process the input image
using var input = new OcrInput();
input.LoadImage("document.png");
// Read text with automatic optimization
var result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr

' Initialize the OCR engine
Dim ocr As New IronTesseract()

' Load and process the input image
Using input As New OcrInput()
    input.LoadImage("document.png")
    ' Read text with automatic optimization
    Dim result = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

IronTesseract 类提供了一个托管包装器，可以自动处理内存使用。 OcrInput 类直接接受图像文件输入，支持文件路径、字节数组、流或 System.Drawing 对象，无需格式转换。 生成的 result 对象包含如置信度得分、单词位置和段落边界等结构化数据，这些对于构建复杂的文档处理管道非常有价值。 查看完整的图像转文本教程，了解更多高级功能。

输入

输出

Tesseract 预处理限制

Tesseract 引擎旨在处理干净、高分辨率的图像文件，并正确引导文本。 在处理旋转或嘈杂的图像时，OCR 引擎经常会返回乱码输出或完全无法识别文本。 要解决这些图像质量问题，需要使用 ImageMagick、OpenCV 等外部工具，或者在将图像传递给 OCR 引擎之前必须运行的自定义预处理代码。

这种预处理开销会增加大量的 .NET 开发时间。每种文档类型都可能需要不同的校正例程，而在不同的输入中调整这些管道以获得最佳结果本身就是一个项目。 低估这项工作的团队往往会发现，Tesseract 的"免费"成本会被数周的预处理工作所抵消。

IronOCR 内置图像预处理

using IronOcr;
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage("skewed-scan.png");
// Apply automatic corrections for high accuracy
input.Deskew();  // Correct skew on rotated images
input.DeNoise(); // Remove digital noise
var result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage("skewed-scan.png");
// Apply automatic corrections for high accuracy
input.Deskew();  // Correct skew on rotated images
input.DeNoise(); // Remove digital noise
var result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr

Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadImage("skewed-scan.png")
    ' Apply automatic corrections for high accuracy
    input.Deskew()  ' Correct skew on rotated images
    input.DeNoise() ' Remove digital noise
    Dim result = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

IronOCR支持图像校正滤镜，可自动解决常见的文档质量问题。 Deskew() 方法通过检测文本行角度并应用补偿旋转来校正倾斜。 DeNoise() 方法移除扫描或数字噪声中的伪影，这些伪影可能会混淆文本识别。 附加滤镜包括 EnhanceResolution() 以改善低DPI图像，Sharpen() 以处理模糊文档，Contrast() 以恢复褪色文字，以及 Invert() 以处理亮底暗字的文档。 这些内置的图像预处理工具在大多数文档处理场景中消除了对外部图像处理库的需求。

输入

输出

Tesseract 格式要求

Tesseract 的底层 Leptonica 库可在内部使用 PIX 格式的图像。 虽然 .NET 封装程序会自动处理某些转换，但多页 TIFF 或 PDF 文档等复杂的图像格式需要额外的处理，通常还需要外部库。 .NET 开发人员经常遇到难以将 System.Drawing 对象或 Stream 来源转换成 Tesseract 引擎所需的格式的问题，尤其是在处理来自 Web 应用的图像或数据库 blob 存储时。

多帧 GIF 和多页 TIFF 需要手动遍历帧，这给原本简单的文本提取任务增加了样板代码。

IronOCR 格式的灵活性

using IronOcr;
var ocr = new IronTesseract();
using var input = new OcrInput();
// Load various image formats directly
input.LoadImage("photo.jpg");
input.LoadImage("screenshot.png");
input.LoadImage("fax.tiff");
input.LoadPdf("scanned-contract.pdf");
var result = ocr.Read(input);
Console.WriteLine(result.Text);

using IronOcr;
var ocr = new IronTesseract();
using var input = new OcrInput();
// Load various image formats directly
input.LoadImage("photo.jpg");
input.LoadImage("screenshot.png");
input.LoadImage("fax.tiff");
input.LoadPdf("scanned-contract.pdf");
var result = ocr.Read(input);
Console.WriteLine(result.Text);

Imports IronOcr

Dim ocr As New IronTesseract()
Using input As New OcrInput()
    ' Load various image formats directly
    input.LoadImage("photo.jpg")
    input.LoadImage("screenshot.png")
    input.LoadImage("fax.tiff")
    input.LoadPdf("scanned-contract.pdf")
    Dim result = ocr.Read(input)
    Console.WriteLine(result.Text)
End Using

IronOCR支持所有主流图像格式，包括 JPG、PNG、GIF、TIFF、BMP 和 WebP。该库可自动处理多页 TIFF 和 GIF 文件，将每一帧作为单独的页面进行处理。 对于文档数字化，图书馆直接处理 PDF 文件输入——从扫描页面中提取文本，而无需单独的 PDF 处理库或图像转换步骤。

输出

Tesseract 语言配置

using TesseractOCR;
using TesseractOCR.Enums;
// Requires downloading fra.traineddata to tessdata folder
using var engine = new Engine(@"./tessdata", Language.French, EngineMode.Default);

using TesseractOCR;
using TesseractOCR.Enums;
// Requires downloading fra.traineddata to tessdata folder
using var engine = new Engine(@"./tessdata", Language.French, EngineMode.Default);

Imports TesseractOCR
Imports TesseractOCR.Enums

' Requires downloading fra.traineddata to tessdata folder
Using engine As New Engine("./tessdata", Language.French, EngineMode.Default)
End Using

每种语言都需要从 Tesseract GitHub 仓库 下载相应的 .traineddata 文件，并将其放置在正确的 tessdata 文件夹中。 对于多语言文档，需要在 engine 初始化时指定多种语言。 在开发、测试和生产环境中管理这些语言文件，并确保所有部署目标在输出目录中都有正确的版本，这增加了操作复杂性，而且随着语言需求的增长，这种复杂性还会加剧。

IronOCR语言包配置

using IronOcr;
var ocr = new IronTesseract();
// Install IronOcr.Languages.French NuGet package first
ocr.Language = OcrLanguage.French;
// Process multi-language documents
ocr.AddSecondaryLanguage(OcrLanguage.German);

using IronOcr;
var ocr = new IronTesseract();
// Install IronOcr.Languages.French NuGet package first
ocr.Language = OcrLanguage.French;
// Process multi-language documents
ocr.AddSecondaryLanguage(OcrLanguage.German);

Imports IronOcr

Dim ocr As New IronTesseract()
' Install IronOcr.Languages.French NuGet package first
ocr.Language = OcrLanguage.French
' Process multi-language documents
ocr.AddSecondaryLanguage(OcrLanguage.German)

IronOCR将语言包作为NuGet包分发，并与标准的.NET依赖项管理工具集成。 该库支持127 种以上的语言，包括专门的手写体和特定脚本变体，能够优雅地处理多语言文档。 构建过程中的包还原可确保所有必需的语言文件自动部署，无需手动文件管理或版本控制。

Tesseract 平台面临的挑战

Tesseract .NET 封装实现依赖于为特定平台编译的本地 C++ 库。 DLL 或共享库文件因 Windows、Linux 和 macOS 以及 32 位和 64 位架构而异。 部署到 Linux 需要与 Windows 不同的二进制文件，并在部署环境中配置适当的库路径。

云部署带来了额外的挑战。 Azure App Services、AWS Lambda 和容器化环境可能缺乏原生 Tesseract 所需的 Visual C++ 运行时。 在 Docker 容器或无服务器功能中安装这些依赖项会增加构建管道的复杂性并增大映像大小。 许多.NET开发人员遇到过这样的情况：当原生依赖项没有正确打包时，部署就会失败，而这些依赖项在本地 Visual Studio 开发中却运行良好。

IronOCR 跨平台一致性

IronOCR for .NET 以纯托管 .NET 库的形式运行，无需管理外部本地依赖关系。 同一个NuGet包可以在 Windows、macOS、Linux、 Azure 应用服务、 AWS Lambda和Docker 容器中稳定运行。 这种架构大大简化了 CI/CD 管道，使您可以在本地构建并可靠地部署到生产环境中，而无需调整特定平台的配置。

Tesseract结果访问

using var page = engine.Process(img);
// Basic OCR text output
string text = page.Text;
// Confidence score (mean across all recognized text)
float confidence = page.GetMeanConfidence();

using var page = engine.Process(img);
// Basic OCR text output
string text = page.Text;
// Confidence score (mean across all recognized text)
float confidence = page.GetMeanConfidence();

Imports System

Using page = engine.Process(img)
    ' Basic OCR text output
    Dim text As String = page.Text
    ' Confidence score (mean across all recognized text)
    Dim confidence As Single = page.GetMeanConfidence()
End Using

Tesseract 可提供识别文本和总体置信度评分。 要访问更精细的数据，如单个单词的位置或每个字符的置信度，需要调用额外的 API 并仔细迭代结果结构。 API接口功能齐全，但缺少生产文档管道通常需要的分层结果模型。

带有置信度分数的 IronOCR 结构化结果

using IronOcr;
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage("document.png");
var result = ocr.Read(input);
// Full text extraction
Console.WriteLine(result.Text);
// Iterate through structured elements with confidence scores
foreach (var page in result.Pages)
{
    foreach (var paragraph in page.Paragraphs)
    {
        Console.WriteLine($"Paragraph: {paragraph.Text}");
        Console.WriteLine($"Confidence: {paragraph.Confidence}%");
    }
}

using IronOcr;
var ocr = new IronTesseract();
using var input = new OcrInput();
input.LoadImage("document.png");
var result = ocr.Read(input);
// Full text extraction
Console.WriteLine(result.Text);
// Iterate through structured elements with confidence scores
foreach (var page in result.Pages)
{
    foreach (var paragraph in page.Paragraphs)
    {
        Console.WriteLine($"Paragraph: {paragraph.Text}");
        Console.WriteLine($"Confidence: {paragraph.Confidence}%");
    }
}

Imports IronOcr

Dim ocr As New IronTesseract()
Using input As New OcrInput()
    input.LoadImage("document.png")
    Dim result = ocr.Read(input)
    ' Full text extraction
    Console.WriteLine(result.Text)
    ' Iterate through structured elements with confidence scores
    For Each page In result.Pages
        For Each paragraph In page.Paragraphs
            Console.WriteLine($"Paragraph: {paragraph.Text}")
            Console.WriteLine($"Confidence: {paragraph.Confidence}%")
        Next
    Next
End Using

OcrResult 类提供对页面、段落、行、单词和单个字符的分层访问。 每个元素都包含边界框坐标和置信度分数，使.NET应用程序能够突出显示识别的文本区域、从特定区域提取内容、验证识别质量或标记置信度低的部分以供人工审核。 IronOCR还可以将结果直接导出为可搜索的 PDF或hOCR/HTML 格式，以便进行存档和搜索索引。

输出

Tesseract 何时最合适

Tesseract 在特定场景下表现良好，其优缺点可以接受：

• 预算限制要求采用开源的 Apache 2.0 许可解决方案。
• 仅处理干净、高质量的数字文档（原生数字 PDF、屏幕截图） 开发团队拥有 C++ 互操作性和原生库管理方面的经验
• 项目要求仅限于基本的 OCR 文本提取，不含高级功能 目标部署环境是一个受控环境，可以在其中一致地管理依赖项。

IronOCR带来更佳效果

IronOCR是生产工作负载的更佳选择：

• 构建生产级.NET应用程序，其中 OCR 准确性会影响业务成果
• 处理不同质量的文件，包括扫描件、照片、传真和移动采集件
• 跨多个平台或云环境部署，一致性至关重要
• 需要专业的技术支持，定期进行错误修复和功能更新
• 开发时间表不允许我们应对配置和预处理方面的挑战
• 要求包括PDF文件处理、条形码和二维码读取，或结构化结果数据处理

对于之前构建过基于 Tesseract 的管道并且正在评估迁移的团队， IronOCR迁移指南涵盖了关键的 API 差异和过渡步骤。