OCR C# GitHub：使用 IronOCR 進行文字識別

您應該使用哪種安裝方法？

首先通過NuGet封裝管理器安裝IronOCR：

Install-Package IronOcr

使用NuGet安裝

PM >  Install-Package IronOcr

查看在NuGet上的https://www.nuget.org/packages/IronOcr，快速安裝。超過1000萬次下載，正在用C#轉變PDF開發。 您也可以下載DLL或Windows安裝程式。

針對高級安裝場景，請參閱NuGet封裝指南。 如果您要部署到特定平台，請查看Windows，Linux，macOS，或Docker容器的指南。

在哪裡可以找到範例程式碼？

IronOCR維護官方GitHub儲存庫，提供範例和教程。 IronOCR範例儲存庫提供現實世界的實現，而圖像到文字教程儲存庫展示了您可以克隆和修改的實際用例。

這些儲存庫展示了包括條碼閱讀、多語言支援和PDF處理的OCR。 由於IronOCR在NuGet上發布頻繁的封裝，您將始終可以存取最新的穩定版本。

您應該使用哪種項目結構？

MyOcrProject/
├── src/
│   └── OcrProcessor.cs
├── images/
│   └── sample-invoice.jpg
├── .gitignore
├── README.md
└── MyOcrProject.csproj

這種結構支援各種輸入格式，包括JPG，PNG，TIFF和BMP。對於多頁TIFF或GIF文件的處理，IronOCR會自動處理。

images/文件夾保持樣本文件組織良好，並使得貢獻者可以輕鬆新增測試圖像而不會擾亂根目錄。 將src/文件夾與配置文件分開，讓項目更易於一目了然。 新增一個README.md，解釋項目的功能、應設置的授權金鑰變數以及如何運行樣本。

如何實施OCR處理程式碼？

以下範例展示了一個完整的OCR處理器，展示了IronOCR的主要功能，包括圖像預處理、文字提取和條碼檢測：

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
ocr.Language = OcrLanguage.English;

using var input = new OcrInput();
input.LoadImage("images/sample-invoice.jpg");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(225);

var result = ocr.Read(input);

Console.WriteLine($"Confidence: {result.Confidence}%");
Console.WriteLine($"Text Found:\n{result.Text}");

foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"Barcode: {barcode.Value} ({barcode.Format})");
}

result.SaveAsSearchablePdf("output.pdf");

using IronOcr;

var ocr = new IronTesseract();
ocr.Configuration.ReadBarCodes = true;
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto;
ocr.Language = OcrLanguage.English;

using var input = new OcrInput();
input.LoadImage("images/sample-invoice.jpg");
input.Deskew();
input.DeNoise();
input.EnhanceResolution(225);

var result = ocr.Read(input);

Console.WriteLine($"Confidence: {result.Confidence}%");
Console.WriteLine($"Text Found:\n{result.Text}");

foreach (var barcode in result.Barcodes)
{
    Console.WriteLine($"Barcode: {barcode.Value} ({barcode.Format})");
}

result.SaveAsSearchablePdf("output.pdf");

Imports IronOcr

Dim ocr As New IronTesseract()
ocr.Configuration.ReadBarCodes = True
ocr.Configuration.PageSegmentationMode = TesseractPageSegmentationMode.Auto
ocr.Language = OcrLanguage.English

Using input As New OcrInput()
    input.LoadImage("images/sample-invoice.jpg")
    input.Deskew()
    input.DeNoise()
    input.EnhanceResolution(225)

    Dim result = ocr.Read(input)

    Console.WriteLine($"Confidence: {result.Confidence}%")
    Console.WriteLine($"Text Found:{Environment.NewLine}{result.Text}")

    For Each barcode In result.Barcodes
        Console.WriteLine($"Barcode: {barcode.Value} ({barcode.Format})")
    Next

    result.SaveAsSearchablePdf("output.pdf")
End Using

此範例展示了IronOCR的幾個功能。 構造函式將OCR引擎配置為啟用條碼閱讀和自動頁面分段。 預處理管道展示了去畸（更正旋轉）、去噪（移除干擾）和提升解析度。

處理後，引擎用可信度評分提取英文文字，識別條碼，並生成可搜尋的PDF。 程式碼使用.NET 10的頂級語句編寫，使範例簡短且易讀。

針對高級情境，您可以使用異步處理來提高吞吐量，或為長時間運行的操作實施進度跟蹤。 OcrResult類提供詳細輸出，包括文字位置、單詞坐標和段落結構-為您提供比純文字字串多得多的資訊。

開發者也可以配置IronOCR以閱讀其他語言，例如中文、西班牙語或法語，使其成為多語言GitHub項目的強大選擇。 關於安裝額外語言包的參考資料，請參閱125國際語言指南。

您的.gitignore文件應該包括什麼？

對於您的.gitignore文件，請包含禁止運行時工件、測試輸出和秘密配置被提交的條目：

# IronOCR runtime files
runtimes/
# Test images and outputs
*.pdf
test-images/
output/
# License keys
appsettings.*.json

尤其重要的是將runtimes/文件夾排除在源程式碼控制之外，因為IronOCR在構建時下載平台特定的二進制文件。提交它們會增加您的儲存庫的大小並導致平台衝突。 了解更多有關授權金鑰管理以便正確實施。

IronOCR與其他OCR解決方案有何不同？

IronOCR足夠靈活，可以識別單詞、行和完整段落，讓您可以精確控制從每次掃描中提取多少細節。 該程式庫在特定文件型別上表現優異，包括車牌、護照、手寫文字、截圖和掃描文件。

商業授權為公共儲存庫提供法律上清晰的保障。 您明確被允許將IronOCR納入商業應用程式中。 內建的圖像預處理過濾器包含高級選項，如色彩校正、質量增強和一個預處理向導，自動為困難圖像找到最佳設置。

為什麼單一DLL架構重要？

IronOCR的單一DLL架構意味著貢獻者可以克隆您的儲存庫並立即開始開發，無需與原生依賴項或平台特定的配置作鬥爭，這是其他OCR解決方案所困擾的問題。 這種簡單性正是為什麼開發者選擇IronOCR而不是原生Tesseract的原因。

當您比較設置體驗時，原生Tesseract實現通常需要單獨安裝本機二進制文件、配置PATH變數，並手動管理tessdata語言文件。 IronOCR內部處理所有這些，這意味著您項目的README可以專注於應用程式邏輯而不是環境設置說明。

該程式庫包括Tesseract 5，具有許多性能改進和多執行緒支持，允許您並行處理多個文件，而無需撰寫自訂的執行緒程式碼。

如何在Git中處理大文件？

使用Git LFS來管理大型測試圖像，以保持您的儲存庫大小可控：

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes
git commit -m "Track large image files with Git LFS"

git lfs track "*.jpg" "*.png" "*.tiff"
git add .gitattributes
git commit -m "Track large image files with Git LFS"

這在處理高解析度圖像或多頁TIFF文件時尤為重要。 對於低質量的掃描，IronOCR的預處理可以顯著提高結果，而無需您在提交測試圖像之前手動編輯它們。

在儲存庫中儲存測試文件時，考慮它們是否包含敏感資訊。 最好以程式方式生成合成測試圖像，而不是在私人儲存庫中提交真實發票或身份證明文件。

如何管理授權金鑰和文件？

使用環境變數或.NET使用者密碼庫儲存IronOCR授權金鑰。 絕不要直接將它們提交到任何分支，即使是私人分支。 按照授權金鑰指南正確實施。 您還可以在ASP.NET應用程式的web.config中配置授權。

在您的README中記錄支援的圖像格式和預期的準確率。 在test-data/文件夾中包含範本圖像，以便貢獻者在克隆後能立即驗證OCR功能。 新增一個簡短的部分，解釋如何通過環境變數設置授權金鑰，以便新貢獻者在首次運行時不會被阻止。

有關跨平台開發，請參考IronOCR Linux設置指南或macOS安裝說明。 移動開發者應查看IronOCR文件中的Android和iOS指南。

為什麼OCR在Windows上無法正常工作？

常見的設置問題包括Windows上缺少Visual C++ Redistributables。 IronOCR需要2019版。 有關詳細指導，請參閱Visual C++ Redistributable故障排除指南。 對於Linux部署，請確保已安裝libgdiplus。

如果文字識別效果不佳，請使用DPI設置指南驗證您的圖像至少為200 DPI。 C# OCR社群在Stack Overflow上也提供了有助於解決GitHub項目常見問題的方案。

針對特定配置問題，請使用IronOCR實用工具來診斷問題，並參考常規疑難排解指南進行逐步診斷。

在哪裡可以獲得更多支援？

要進行詳細的故障排除，請參閱IronOCR故障排除指南。 IronOCR支援團隊為GitHub託管的OCR應用程式的授權使用者提供快速協助。 查看產品更新日誌以獲取最新更新。