簡介這份資源面向使用 C# 與 .NET 進行 Word 文檔自動化處理的開發(fā)者重點解決在無 Microsoft Word 環(huán)境下創(chuàng)建、修改和操作文檔的需求。包內(nèi)提供 Spire.Doc 的附加使用 Demo并附帶 Spire.License.dll 授權(quán)文件可激活無限制使用權(quán)限避免文檔數(shù)量或頁數(shù)受限。壓縮包共 19 個文件約 1.89MB以 cs 源碼、dll 組件、sln 解決方案、csproj 工程文件及 resx 資源文件為主另含 exe、pdb、settings 等輔助文件結(jié)構(gòu)完整可直接運行調(diào)試。Demo 覆蓋插入圖片、插入表格、復(fù)制行生成新文檔等典型場景并延伸至文本格式化、樣式模板、郵件合并、文檔保護與格式轉(zhuǎn)換等進階用法。目前已有 3564 人學(xué)習下載適合希望快速掌握 Spire.Doc 核心 API、提升文檔批處理效率的 C# 開發(fā)者參考實踐。1. 當 Word 文檔處理成了項目里的攔路虎這套 C# 方案能省掉不少折騰做過 .NET 項目的人大概都遇到過這種場景后臺要批量生成合同、導(dǎo)出報表、把 HTML 轉(zhuǎn)成 Word 存檔或者從一堆上傳的 docx 里抽取表格數(shù)據(jù)。第一反應(yīng)往往是找 Office Interop結(jié)果部署到服務(wù)器上就翻車——要么機器上沒裝 Office要么 COM 組件權(quán)限報錯要么并發(fā)一高直接卡死。后來換成 OpenXML SDK功能是穩(wěn)了但寫起來啰嗦調(diào)個頁眉頁腳、插個水印得翻半天文檔。這份資源給的是一個基于 C# 和 Spire.Doc 的完整 Demo把文檔創(chuàng)建、內(nèi)容替換、格式轉(zhuǎn)換、表格操作這些高頻需求都封裝好了拿來就能跑也方便二次開發(fā)。它適合正在做 .NET 后臺文檔處理、又不想被 Interop 和 OpenXML 折磨的開發(fā)者。2. 技術(shù)選型與項目結(jié)構(gòu)為什么是 Spire.Doc 而不是 Interop2.1 文檔處理庫的三種路線對比在 .NET 生態(tài)里處理 Word 文檔主流就三條路。第一條是 Microsoft.Office.Interop.Word優(yōu)點是功能全幾乎能操作 Word 的所有能力缺點是強依賴本機安裝 Office服務(wù)器部署成本高COM 釋放不及時還會殘留進程并發(fā)場景基本不可用。第二條是 OpenXML SDK純托管代碼不依賴 Office性能也好缺點是 API 偏底層操作一個段落要層層遍歷寫起來心智負擔重遇到復(fù)雜格式容易漏細節(jié)。第三條就是 Spire.Doc 這類商業(yè)庫純 .NET 實現(xiàn)不依賴 OfficeAPI 設(shè)計貼近 Word 對象模型Document、Section、Paragraph、Table 這些概念直接對應(yīng)上手快。這份 Demo 選的是第三條路。它把 Spire.Doc 的常用能力集中演示了一遍同時因為標題里提到“無限制”說明資源里包含了可用的授權(quán)處理方式避免了商業(yè)庫常見的頁數(shù)限制和水印問題。對于中小型項目來說這種方案在開發(fā)效率和部署便利性之間取了一個不錯的平衡點。2.2 項目目錄與模塊劃分拿到源碼后先看目錄結(jié)構(gòu)。一個典型的 Spire.Doc Demo 項目通常長這樣SpireDocDemo/ ├── SpireDocDemo.sln ├── SpireDocDemo/ │ ├── Program.cs // 控制臺入口演示各功能調(diào)用 │ ├── Services/ │ │ ├── DocumentCreateService.cs // 文檔創(chuàng)建 │ │ ├── DocumentReplaceService.cs // 文本替換 │ │ ├── DocumentConvertService.cs // 格式轉(zhuǎn)換 │ │ └── DocumentTableService.cs // 表格操作 │ ├── Models/ │ │ └── ContractModel.cs // 業(yè)務(wù)數(shù)據(jù)模型 │ ├── Templates/ │ │ └── contract_template.docx │ ├── Output/ │ │ └── (生成的文檔輸出目錄) │ └── SpireDocDemo.csproj這個劃分把不同職責拆到了獨立 Service 里Program.cs 只負責串聯(lián)調(diào)用。二次開發(fā)時你要加新功能照著現(xiàn)有 Service 的模式擴一個類就行不用動入口邏輯。Templates 目錄放模板文件Output 放生成結(jié)果職責清晰。2.3 依賴引入與授權(quán)初始化項目依賴通過 NuGet 引入核心包是 Spire.Doc。在 csproj 里通常能看到ItemGroup PackageReference IncludeSpire.Doc Version10.x.x / /ItemGroup授權(quán)初始化一般放在程序啟動最前面只執(zhí)行一次// Program.cs 入口處 using Spire.Doc; // 應(yīng)用授權(quán)避免生成文檔帶水印或頁數(shù)限制 // 具體授權(quán)字符串由資源包內(nèi)提供替換此處占位即可 Spire.License.LicenseProvider.SetLicenseKey(your-license-key-here); Console.WriteLine(Spire.Doc 授權(quán)初始化完成);這里的關(guān)鍵點是授權(quán)必須在任何 Document 對象創(chuàng)建之前設(shè)置否則第一個文檔可能已經(jīng)帶上了評估水印。常見做法是把授權(quán)字符串放到配置文件或環(huán)境變量里不要硬編碼進源碼提交到倉庫。如果你在團隊里協(xié)作建議單獨抽一個 LicenseInitializer 靜態(tài)類在 Main 方法第一行調(diào)用。3. 核心功能拆解從創(chuàng)建文檔到格式轉(zhuǎn)換的完整鏈路3.1 創(chuàng)建文檔與段落樣式設(shè)置最基礎(chǔ)的功能是憑空生成一個 Word 文檔。Demo 里的 DocumentCreateService 演示了標題、正文、列表的寫法using Spire.Doc; using Spire.Doc.Documents; public class DocumentCreateService { public void CreateSimpleDocument(string outputPath) { // 新建一個空白文檔 Document document new Document(); // 添加一個節(jié)Word 文檔內(nèi)容都掛在節(jié)下面 Section section document.AddSection(); // 添加標題段落 Paragraph title section.AddParagraph(); title.AppendText(項目驗收報告); // 設(shè)置標題樣式Heading1 是內(nèi)置樣式 title.ApplyStyle(BuiltinStyle.Heading1); // 居中對齊 title.Format.HorizontalAlignment HorizontalAlignment.Center; // 添加正文段落 Paragraph body section.AddParagraph(); body.AppendText(本報告用于記錄項目各階段的驗收結(jié)果。); body.Format.FirstLineIndent 21f; // 首行縮進約兩個字符 body.Format.LineSpacing 18f; // 行距 // 保存為 docx document.SaveToFile(outputPath, FileFormat.Docx); document.Dispose(); // 釋放資源 } }邏輯說明Document 是根對象Section 是頁面級容器Paragraph 是段落。ApplyStyle 用的是 Word 內(nèi)置樣式這樣生成的文檔在 Word 里打開時樣式面板能正確識別。FirstLineIndent 的單位是磅21 磅大約對應(yīng)小四號字的兩個字符縮進。LineSpacing 同理。最后必須調(diào)用 Dispose否則文件句柄可能被占用后續(xù)操作會報“文件被另一進程使用”。參數(shù)方面SaveToFile 的第二個參數(shù)決定輸出格式FileFormat.Docx 是默認選擇也可以傳 FileFormat.Doc 生成老格式或者 FileFormat.PDF 直接轉(zhuǎn) PDF。3.2 模板替換批量生成合同的關(guān)鍵實際項目里更常見的是“模板 數(shù)據(jù)”模式。Demo 用書簽和文本替換兩種方式演示public class DocumentReplaceService { public void ReplaceByBookmark(string templatePath, string outputPath) { Document document new Document(); document.LoadFromFile(templatePath); // 替換書簽內(nèi)容書簽在模板里預(yù)先插入 if (document.Bookmarks.Contains(PartyA)) { document.Bookmarks[PartyA].Text 某科技有限公司; } if (document.Bookmarks.Contains(Amount)) { document.Bookmarks[Amount].Text 人民幣壹拾萬元整; } document.SaveToFile(outputPath, FileFormat.Docx); document.Dispose(); } public void ReplaceByText(string templatePath, string outputPath) { Document document new Document(); document.LoadFromFile(templatePath); // 普通文本替換適合占位符場景 document.Replace({{ContractNo}}, HT-2024-001, false, true); document.Replace({{SignDate}}, DateTime.Now.ToString(yyyy年MM月dd日), false, true); document.SaveToFile(outputPath, FileFormat.Docx); document.Dispose(); } }邏輯說明書簽替換適合模板里已經(jīng)定義好書簽位置的場景替換后格式保留得最完整。文本替換更靈活但要注意 Replace 方法的參數(shù)第一個是舊文本第二個是新文本第三個表示是否區(qū)分大小寫第四個表示是否全字匹配。這里傳 false 和 true意思是忽略大小寫且全字匹配避免把“{{ContractNo}}”里的部分字符誤替換。血淚經(jīng)驗文本替換時如果占位符跨了多個 RunWord 里同一段文字可能被拆成多個 Run直接 Replace 可能匹配不到。穩(wěn)妥做法是先用書簽或者在模板里把占位符放在同一個 Run 里。如果遇到替換不生效先檢查模板里占位符是不是被 Word 自動拆分了。3.3 格式轉(zhuǎn)換Word 轉(zhuǎn) PDF 與 HTML格式轉(zhuǎn)換是后臺服務(wù)的剛需。Demo 里演示了 Word 轉(zhuǎn) PDF、Word 轉(zhuǎn) HTMLpublic class DocumentConvertService { public void WordToPdf(string wordPath, string pdfPath) { Document document new Document(); document.LoadFromFile(wordPath); // 直接保存為 PDF document.SaveToFile(pdfPath, FileFormat.PDF); document.Dispose(); } public void WordToHtml(string wordPath, string htmlPath) { Document document new Document(); document.LoadFromFile(wordPath); // 保存為 HTML第二個參數(shù)指定導(dǎo)出選項 document.SaveToFile(htmlPath, FileFormat.Html); document.Dispose(); } }邏輯說明轉(zhuǎn) PDF 是最常用的Spire.Doc 內(nèi)部做了排版引擎轉(zhuǎn)換質(zhì)量在同類庫里算不錯的。轉(zhuǎn) HTML 時要注意圖片默認會導(dǎo)出成單獨文件放在同目錄如果希望圖片內(nèi)嵌成 base64需要額外配置 HtmlExportOptions。常見做法是轉(zhuǎn) HTML 后把圖片目錄一起打包或者用 SaveToStream 配合自定義導(dǎo)出選項。參數(shù)方面SaveToFile 的 FileFormat 枚舉支持 Docx、Doc、PDF、Html、Xml、Txt、Rtf 等。轉(zhuǎn) PDF 時如果文檔里有特殊字體服務(wù)器上沒裝對應(yīng)字體可能顯示異常建議在服務(wù)器上裝好常用中文字體。3.4 表格操作讀寫數(shù)據(jù)與動態(tài)行表格是合同和報表里的重頭戲。Demo 演示了創(chuàng)建表格、填充數(shù)據(jù)、讀取表格內(nèi)容public class DocumentTableService { public void CreateTable(string outputPath) { Document document new Document(); Section section document.AddSection(); // 創(chuàng)建 3 行 4 列的表格 Table table section.AddTable(); table.ResetCells(3, 4); // 填充表頭 string[] headers { 序號, 名稱, 數(shù)量, 單價 }; for (int i 0; i headers.Length; i) { table[0, i].AddParagraph().AppendText(headers[i]); } // 填充數(shù)據(jù)行 table[1, 0].AddParagraph().AppendText(1); table[1, 1].AddParagraph().AppendText(辦公桌); table[1, 2].AddParagraph().AppendText(10); table[1, 3].AddParagraph().AppendText(800); document.SaveToFile(outputPath, FileFormat.Docx); document.Dispose(); } public void ReadTable(string filePath) { Document document new Document(); document.LoadFromFile(filePath); // 遍歷所有節(jié)和表格 foreach (Section section in document.Sections) { foreach (Table table in section.Tables) { for (int r 0; r table.Rows.Count; r) { for (int c 0; c table.Rows[r].Cells.Count; c) { string text table[r, c].Text; Console.WriteLine($行{r}列{c}: {text}); } } } } document.Dispose(); } }邏輯說明ResetCells 一次性設(shè)定行列數(shù)比逐行添加效率高。table[r, c] 是索引器直接定位單元格。讀取時注意 table[r, c].Text 拿到的是單元格內(nèi)所有段落的純文本拼接如果單元格里有多個段落可能需要遍歷 Paragraphs 逐個取。踩坑提醒動態(tài)添加行時不要用 ResetCells 反復(fù)重置那樣會清空已有數(shù)據(jù)。正確做法是 table.AddRow() 追加行或者一開始就按最大行數(shù)創(chuàng)建再按需隱藏空行。4. 避坑與常見問題排查那些年我們踩過的文檔處理坑4.1 授權(quán)未生效導(dǎo)致水印和頁數(shù)限制現(xiàn)象生成的文檔第一頁頂部有評估水印或者超過一定頁數(shù)后內(nèi)容被截斷。 原因授權(quán)字符串沒設(shè)置或者設(shè)置時機太晚在 Document 創(chuàng)建之后才調(diào)用 SetLicenseKey。 解決把授權(quán)初始化放到 Main 方法第一行確保在任何 Document 實例化之前執(zhí)行。如果用的是配置文件檢查讀取邏輯有沒有異常吞掉。另外注意授權(quán)字符串不要有多余空格或換行。4.2 文件被占用導(dǎo)致保存失敗現(xiàn)象調(diào)用 SaveToFile 時拋異常提示“文件正被另一進程使用”。 原因上一次操作的 Document 對象沒有 Dispose文件句柄沒釋放或者輸出路徑的文件正被 Word 打開。 解決所有 Document 對象用 using 包裹或者手動在 finally 里 Dispose。輸出前檢查目標文件是否被占用必要時先刪再寫。服務(wù)器上建議輸出到臨時目錄再移動避免直接覆蓋正在被讀取的文件。4.3 中文字體在服務(wù)器上顯示為方框現(xiàn)象本地開發(fā)機生成的 PDF 正常部署到服務(wù)器后中文變成方框或亂碼。 原因服務(wù)器上沒有安裝文檔里用到的中文字體Spire.Doc 找不到字體就回退到默認字體而默認字體不含中文字形。 解決在服務(wù)器上安裝常用中文字體如宋體、黑體、微軟雅黑或者在代碼里顯式指定字體。Linux 服務(wù)器可以用 fontconfig 安裝字體包。另一個辦法是嵌入字體但會增加文件體積。4.4 文本替換匹配不到跨 Run 的占位符現(xiàn)象模板里明明有 {{Name}}Replace 調(diào)用后沒變化。 原因Word 在保存時可能把 {{Name}} 拆成多個 Run比如 “{{”、“Name”、“}}” 分屬不同 RunReplace 按 Run 匹配就找不到完整字符串。 解決優(yōu)先用書簽替代文本占位符。如果必須用文本替換可以在模板里把占位符放在連續(xù)輸入的一段里避免中途改格式?；蛘咴诖a里先合并 Run 再替換但這樣會丟失局部格式。4.5 并發(fā)場景下的線程安全問題現(xiàn)象多線程同時調(diào)用文檔生成偶爾出現(xiàn)文件損壞或異常。 原因Spire.Doc 的 Document 對象不是線程安全的多個線程共享同一個 Document 實例會出問題。 解決每個線程獨立創(chuàng)建 Document 對象不要復(fù)用。如果并發(fā)量高考慮用對象池或者隊列串行化處理。另外授權(quán)初始化是全局的只需執(zhí)行一次多線程重復(fù)設(shè)置可能引發(fā)競爭。5. 二次開發(fā)改造把這套 Demo 變成你自己的文檔服務(wù)5.1 封裝成可注入的文檔服務(wù)Demo 里的 Service 是直接 new 出來的實際項目里更推薦用依賴注入。把各個 Service 抽成接口注冊到 DI 容器public interface IDocumentService { byte[] GenerateFromTemplate(string templatePath, Dictionarystring, string data); byte[] ConvertToPdf(byte[] wordBytes); } public class DocumentService : IDocumentService { public byte[] GenerateFromTemplate(string templatePath, Dictionarystring, string data) { using (Document document new Document()) { document.LoadFromFile(templatePath); foreach (var kv in data) { document.Replace(${{{{{kv.Key}}}}}, kv.Value, false, true); } using (MemoryStream ms new MemoryStream()) { document.SaveToStream(ms, FileFormat.Docx); return ms.ToArray(); } } } public byte[] ConvertToPdf(byte[] wordBytes) { using (Document document new Document()) using (MemoryStream input new MemoryStream(wordBytes)) { document.LoadFromStream(input, FileFormat.Docx); using (MemoryStream output new MemoryStream()) { document.SaveToStream(output, FileFormat.PDF); return output.ToArray(); } } } }這樣改造的好處是輸入輸出都用 Stream 或 byte[]不依賴本地文件路徑方便在 Web API 里直接返回文件流。DI 注冊時用 AddSingleton 還是 AddScoped 取決于并發(fā)量Spire.Doc 本身不持有跨請求狀態(tài)Singleton 也能用但要注意線程安全。5.2 模板管理的工程化思路模板文件不要散落在代碼目錄里。常見做法是放到數(shù)據(jù)庫或?qū)ο蟠鎯τ冒姹咎柟芾?。生成時根據(jù)業(yè)務(wù)類型和版本號拉取模板替換后輸出。這樣模板更新不需要重新部署應(yīng)用。如果模板量不大也可以放文件系統(tǒng)但要用配置指定根目錄不要硬編碼相對路徑。5.3 性能優(yōu)化與批量處理批量生成幾百份合同時逐個創(chuàng)建 Document 對象開銷不小?？梢詮?fù)用一個 Document 實例每次 LoadFromFile 重新加載模板替換后 SaveToStream然后 Reset 再處理下一個。但要注意 Reset 是否徹底釋放了上一次的內(nèi)容。更穩(wěn)妥的做法還是每個文檔獨立實例配合并行處理。實測在 4 核機器上并行度設(shè)為 CPU 核數(shù)時吞吐量比較理想。5.4 驗證改造是否成功的檢查清單改完之后怎么確認沒問題我一般會走一遍這幾個檢查點生成的文檔用 Word 打開看樣式、頁眉頁腳、頁碼是否正常轉(zhuǎn) PDF 后檢查中文字體和分頁批量跑 100 份看內(nèi)存有沒有持續(xù)增長并發(fā) 10 個請求看有沒有文件沖突異常。這套流程走下來基本能覆蓋大部分翻車場景。從那以后我每次接入新的文檔處理庫都強制先跑一遍授權(quán)、并發(fā)、字體這三個檢查點確認沒問題再往業(yè)務(wù)里集成。希望幫到你。本文還有配套的精品資源點擊獲取