您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計綜合問答

C# 操作 Word 文件完全指南：Microsoft.Office.Interop.Word 最佳實踐

編輯：程式設計綜合問答

技術選型對比

方案	優點	缺點	適用場景
Interop (COM 自動化)	功能完整 (100% Word 能力)、支援複雜排版/列印/轉 PDF、原生事件模型	需安裝 Word、不可在伺服器端無人值守運行 (EULA 限制)、效能差、版本相容性問題、記憶體洩漏風險	桌面端工具、批次列印、需精確還原 Word 排版
Open XML SDK (Office Open XML)	無需安裝 Office、高效能、伺服器端安全、開源、跨平台	學習曲線陡峭、需理解 OOXML 結構、複雜排版轉換需自行實作	伺服器端報表生成、大量文件處理、雲端服務
第三方庫 (Aspose.Words, DocX, NPOI)	API 友好、無 Office 依賴、功能豐富	商業授權成本 (Aspose)、部分功能不如 Interop 完整	商業專案、需平衡開發效率與部署限制

Interop 核心開發模式 (原答案推薦)

1. 宏錄製法 - 最高效學習路徑

Word 中：檢視 → 巨集 → 錄製巨集。
手動執行目標操作 (插入表格、設定樣式、郵件合併...)。
停止錄製 → 編輯巨集 → 獲得 **VBA 代碼**。
將 VBA 翻譯為 C#：
`Selection` → `app.Selection`
`ActiveDocument` → `doc`
`With ... End With` → 連續屬性設定
變數宣告加型別、`Set` 關鍵字移除。

2. C# 基礎自動化範本

using Word = Microsoft.Office.Interop.Word;
using System.Runtime.InteropServices;

public void GenerateReport() {
    Word.Application app = null;
    Word.Document doc = null;
    try {
        app = new Word.Application();
        app.Visible = false; // 後台運行
        app.DisplayAlerts = Word.WdAlertLevel.wdAlertsNone;
        
        doc = app.Documents.Add(Template: @"C:\Templates\Report.dotx"); // 或 Add() 新建
        
        // 書籤替換
        if (doc.Bookmarks.Exists("Title")) 
            doc.Bookmarks["Title"].Range.Text = "年度報告";
        
        // 表格填充
        Word.Table table = doc.Tables[1];
        table.Cell(2, 2).Range.Text = "數據值";
        
        // 另存為 PDF
        doc.SaveAs2(@"C:\Output\Report.pdf", Word.WdSaveFormat.wdFormatPDF);
    }
    catch (Exception ex) { /* 日誌記錄 */ }
    finally {
        // 嚴格釋放 COM 物件 (逆序)
        if (doc != null) { doc.Close(false); Marshal.ReleaseComObject(doc); }
        if (app != null) { app.Quit(false); Marshal.ReleaseComObject(app); }
        GC.Collect(); GC.WaitForPendingFinalizers(); // 強制清理
    }
}

3. 關鍵坑點與對策

COM 物件釋放： **必須**使用 `Marshal.ReleaseComObject()` 釋放每一個 RCW (Runtime Callable Wrapper)，否則 Word 進程殘留 (Task Manager 看到 WINWORD.EXE 不退出)。
版本無關性： 專案引用「Microsoft Word 16.0 Object Library」但設定 **Embed Interop Types = True** (預設)，或使用 **Late Binding** (`Type.GetTypeFromProgID("Word.Application")`) 避免版本綁定。
區域性設定： 執行緒 `CurrentCulture` 影響日期/數字格式，建議 `Thread.CurrentThread.CurrentCulture = new CultureInfo("en-US");` 統一。
伺服器端禁用： Microsoft 明確禁止在 ASP.NET/Windows Service 等非互動環境使用 Interop。違反 EULA 且極不穩定。**伺服器端請用 Open XML SDK 或 Aspose.Words**。