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