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# 代码：

csharp 复制代码

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。完整代码如下，支持批量与条件替换：

csharp 复制代码

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() 释放资源。

异常处理：

csharp 复制代码

try { /* 加载与处理 */ }
catch (Exception ex) { Console.WriteLine(ex.Message); }

兼容性：支持 Word 365 格式，测试多语言文档时优先 "SimSun" (宋体)。
字体嵌入：替换后保存为 Docx2019，确保字体随文档携带。

总结

Spire.Doc for .NET 简化了 C# Word 字体替换的步骤，实现高效查找和替换字体。开发者可据此标准化文档，提升跨平台兼容。你可以先先下载 Spire.Doc 免费试用版，运行本文代码，验证自动化字体管理。