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

應該使用哪種安裝方法？

首先透過 NuGet 套件管理器安裝 IronOCR：

Install-Package IronOcr

Visual Studio 中的 NuGet 套件管理器視窗顯示了 IronOCR 套件的搜尋結果，其中包含可供安裝的各種語言套件。

!{--010011000100100101000010010100100100000101010010010110010101111101001110010101010101010101010101010101010101010 0100010111110100100101001101010100010000010100110001001100010111110100001001001100010011110010101010

對於進階安裝場景，請參閱NuGet 套件指南。 如果您要部署到特定平台，請查看Windows 、 Linux 、macOS 或 Docker 容器的指南。

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

IronOCR 維護著官方的 GitHub 程式碼庫，其中包含範例和教程。 IronOCR 範例庫提供了真實世界的實現，而影像轉文字教學庫則展示了您可以複製和修改的實際用例。

這些儲存庫展示了 OCR 條碼讀取、多語言支援和 PDF 處理功能。 由於 IronOCR 經常在NuGet上發佈軟體包，因此您將始終能夠存取最新的穩定版本。

流程圖展示了 OCR 處理流程：GitHub OCR 程式碼庫 → IronOCR 專案 → OCR 處理 → 擷取的文字輸出

應該採用哪種專案結構？

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 種國際語言指南。

分割畫面顯示 OCR 示範：左側顯示白色背景上的傾斜 Lorem Ipsum 文字，右側顯示 Visual Studio 偵錯控制台，其中包含提取的文字輸出和 87.34% 的置信度得分。

你的 .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 指南。

為什麼Windows系統上的OCR功能無法正常運作？

常見的安裝問題包括 Windows 系統缺少 Visual C++ 可再發行元件套件。 IronOCR 需要 2019 版本。 有關詳細指導，請參閱Visual C++ Redistributable 故障排除指南。 對於 Linux 部署，請確保已安裝 libgdiplus。

如果文字辨識效果不佳，請使用DPI 設定指南驗證您的影像是否至少為 200 DPI。 Stack Overflow上的 C# OCR 社群也為常見的 GitHub 專案問題提供了有用的解決方案。

對於特定的配置問題，請使用IronOCR 實用工具診斷問題，並參考一般故障排除指南進行逐步診斷。

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

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