C# 實現 Excel 文檔全文搜索：COM 互操作與 Range.Find 高效定位

業務常需「在 Excel 中搜索關鍵字」，本文基於 Microsoft.Office.Interop.Excel COM 互操作，提供兩種搜索方案：**高效的 Range.Find 一行定位**與**全單元格遍歷兜底**，並解析 UsedRange 索引陷阱與資源釋放最佳實踐。

核心對象模型速覽

Application → Workbooks → Workbook → Worksheets → Worksheet → Range(UsedRange) → Find()

方案一：Range.Find 原生搜索（推薦，極快）

using Excel = Microsoft.Office.Interop.Excel;
using System.Reflection; // Missing.Value

public bool SearchExcelWithFind(string filePath, string keyword)
{
    Excel.Application app = null;
    Excel.Workbook wb = null;
    try
    {
        app = new Excel.ApplicationClass { Visible = false, DisplayAlerts = false };
        wb = app.Workbooks.Open(filePath, Missing.Value, true /*ReadOnly*/, 
                                  Missing.Value, Missing.Value, Missing.Value,
                                  Missing.Value, Missing.Value, Missing.Value,
                                  Missing.Value, Missing.Value, Missing.Value,
                                  Missing.Value, Missing.Value, Missing.Value);

        object missing = Missing.Value;
        object searchText = keyword.Trim().ToUpper();
        int sheetCount = wb.Worksheets.Count;

        for (int i = 1; i <= sheetCount; i++) // 索引從 1 開始！
        {
            Excel.Worksheet ws = (Excel.Worksheet)wb.Worksheets[i];
            Excel.Range used = ws.UsedRange;
            if (used == null) continue;

            // Find 參數：What, After, LookIn, LookAt, SearchOrder, SearchDirection, MatchCase, MatchByte, SearchFormat
            Excel.Range found = used.Find(searchText, missing, 
                Excel.XlFindLookIn.xlValues, Excel.XlLookAt.xlPart,
                Excel.XlSearchOrder.xlByRows, Excel.XlSearchDirection.xlNext,
                false, missing, missing);

            if (found != null && found.Cells.Count >= 1)
            {
                // 找到：found.Row, found.Column, found.Value2 可用
                return true;
            }
            Marshal.ReleaseComObject(ws);
        }
        return false;
    }
    finally
    {
        if (wb != null) { wb.Close(false); Marshal.ReleaseComObject(wb); }
        if (app != null) { app.Quit(); Marshal.ReleaseComObject(app); }
        GC.Collect(); GC.WaitForPendingFinalizers(); // 強制釋放 COM
    }
}

關鍵參數說明

方案二：全單元格遍歷（兜底，可定制邏輯）

public bool SearchExcelByIteration(string filePath, string keyword)
{
    Excel.Application app = new Excel.ApplicationClass { Visible = false };
    Excel.Workbook wb = app.Workbooks.Open(filePath, Missing.Value, true, Missing.Value, Missing.Value, Missing.Value, Missing.Value, Missing.Value, Missing.Value, Missing.Value, Missing.Value, Missing.Value, Missing.Value, Missing.Value, Missing.Value);
    
    try
    {
        string kw = keyword.Trim().ToUpper();
        int sheetCount = wb.Worksheets.Count;

        for (int i = 1; i <= sheetCount; i++)
        {
            Excel.Worksheet ws = (Excel.Worksheet)wb.Worksheets[i];
            Excel.Range used = ws.UsedRange;
            if (used == null) continue;

            int startRow = used.Row;           // 起始行（通常 1）
            int startCol = used.Column;        // 起始列（通常 1）
            int rowCount = used.Rows.Count;
            int colCount = used.Columns.Count;

            // 陷阱：單儲格 UsedRange 時 Row/Column 可能為 1，但索引仍從 1 開始
            // 多儲格時 Row/Column 仍為起始位置，索引從 1 到 Count
            for (int r = 1; r <= rowCount; r++)
            {
                for (int c = 1; c <= colCount; c++)
                {
                    Excel.Range cell = (Excel.Range)used.Cells[r, c];
                    string val = (cell.Value2 ?? "").ToString().ToUpper();
                    if (val.IndexOf(kw) >= 0) return true;
                    Marshal.ReleaseComObject(cell);
                }
            }
            Marshal.ReleaseComObject(used);
            Marshal.ReleaseComObject(ws);
        }
        return false;
    }
    finally { wb.Close(false); Marshal.ReleaseComObject(wb); app.Quit(); Marshal.ReleaseComObject(app); GC.Collect(); GC.WaitForPendingFinalizers(); }
}

UsedRange 索引陷阱深度解析

• 單儲格：UsedRange.Rows.Count = 1, Columns.Count = 1，Cells[1,1] 有效。
• 多儲格：Cells[1,1] ~ Cells[Rows.Count, Columns.Count] 全有效，**索引始終從 1 開始**，與 UsedRange.Row/Column 無關（它們只是左上角坐標）。
• 原文提到的「單行單列起始索引 1，多行多列起始索引 0」是**錯誤觀測**；實測所有情況均為 1 基索引。

生產環境避坑指南

1. 服務端不可裝 Office：生產機嚴禁安裝 Office，改用 **EPPlus / NPOI / ClosedXML** 純托管庫，無 COM、無進程殘留、性能更強。
2. 大文件流式讀取：NPOI SXSSFWorkbook / EPPlus 支持流式寫入，搜索需全讀，建議拆分為「索引構建（後台任務）+ 關鍵字查詢（倒排索引/資料庫）」架構。
3. 密碼保護文件：Workbooks.Open(..., password)，失敗捕獲異常記錄日誌。
4. 併發控制：COM 單線程套間 (STA)，高併發必須用進程池或改用純托管庫。
5. 資源洩漏：每個 COM 對象用完即 Marshal.ReleaseComObject，循環內釋放 Range/Worksheet，最後 GC.Collect() 兩次。

現代替代方案對比

搜索 Excel 核心在於 **用對工具、釋放資源、避開 COM 陷阱**。新項目首選 EPPlus/NPOI，舊項目維護時做好 COM 釋放與異常兜底。