C#使用Spire.Doc for .NET获取并替换Word文档中的字体
作者：缺点内向
在企业文档处理流程中，C# Word 字体替换需求频繁出现。手动查找并替换 Word 文档字体，不仅耗费时间，还易遗漏，尤其跨平台共享时，字体缺失常导致显示乱码或布局偏移。Spire.Doc for .NET 作为专业库，提供查找并替换字体功能，支持自动化批量操作。本文基于 Spire.Doc，分享精确 C# 代码，实现字体标准化。
Word 文档字体管理的原理
Word 文档（.docx）以 XML 格式存储字体信息，主要通过 CharacterFormat 类定义每个 TextRange 的字体属性，包括 FontName、FontSize 和 FontStyle。文档加载时，若系统缺少指定字体，默认替换为“Calibri”或“Times New Roman”，但这无法满足企业统一规范。
常见痛点：
- 嵌入字体缺失：Windows “微软雅黑” 在 Mac 上变“Helvetica”，影响专业性。
- 多语言兼容：2024 Word 更新增强 Unicode 支持，但跨系统仍需替换为通用字体。
- 批量场景：数千文档标准化，手动操作效率低下。
Spire.Doc 通过遍历文档结构，实现精确字体扫描与替换，处理速度达手动 20 倍。
使用 Spire.Doc for .NET 获取文档字体
Spire.Doc 的 GetAllFonts() 方法可一键获取文档所有字体。安装 NuGet 包 Install-Package Spire.Doc 后，使用以下 C# 代码：
using Spire.Doc;
using System;
using System.Collections.Generic;
class Program
{
static void Main()
{
Document doc = new Document("input.docx");
List<string> fonts = new List<string>(doc.GetAllFonts());
Console.WriteLine("文档字体列表：");
foreach (string font in fonts)
{
Console.WriteLine($"- {font}");
}
doc.Close();
}
}
关键 API 表格：
| API | 描述 | 返回类型 |
|---|---|---|
GetAllFonts() | 获取唯一字体集合 | IEnumerable<string> |
CharacterFormat.FontName | 文本范围字体名 | string |
输出示例：
文档字体列表： - 微软雅黑 - Arial - Times New Roman
此步骤用于预分析，确定替换目标。
实现 C# Word font replacement 功能
核心逻辑：遍历段落 Paragraph 和文本范围 TextRange，条件替换 FontName。完整代码如下，支持批量与条件替换：
using Spire.Doc;
class Program
{
static void Main()
{
Document doc = new Document("input.docx");
foreach (Section section in doc.Sections)
{
foreach (Paragraph para in section.Paragraphs)
{
foreach (DocumentObject obj in para.ChildObjects)
{
if (obj.DocumentObjectType == DocumentObjectType.TextRange)
{
TextRange tr = obj as TextRange;
if (tr.CharacterFormat.FontName == "微软雅黑")
{
tr.CharacterFormat.FontName = "宋体";
tr.CharacterFormat.FontSize = 12f;
}
}
}
}
}
doc.DefaultSubstitutionFontName = "Arial"; // 缺失字体默认替换
doc.SaveToFile("output.docx", FileFormat.Docx2019);
doc.Close();
}
}
效率对比表格：
| 操作方式 | 100 页文档时间 | 准确率 |
|---|---|---|
| 手动替换 | 25 分钟 | 90% |
| Spire.Doc 自动化 | 2 秒 | 100% |
高级用法：结合 SetCustomFonts() 嵌入自定义字体包，确保跨平台一致。
最佳实践与注意事项
- 性能优化：超大文档分节处理，避免内存溢出；使用
doc.ClearCustomFonts()释放资源。 - 异常处理：
try { /* 加载与处理 */ }
catch (Exception ex) { Console.WriteLine(ex.Message); }
- 兼容性：支持 Word 365 格式，测试多语言文档时优先 “SimSun” (宋体)。
- 字体嵌入：替换后保存为 Docx2019，确保字体随文档携带。
总结
Spire.Doc for .NET 简化了 C# Word 字体替换的步骤，实现高效查找和替换字体。开发者可据此标准化文档，提升跨平台兼容。你可以先先下载 Spire.Doc 免费试用版，运行本文代码，验证自动化字体管理。
到此这篇关于C#使用Spire.Doc for .NET获取并替换Word文档中的字体的文章就介绍到这了,更多相关C#获取并替换Word字体内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！