详情

首页手游攻略 C#快速查找并高亮Word文档中的文字(普通查找+正则表达式)实用指南

C#快速查找并高亮Word文档中的文字(普通查找+正则表达式)实用指南

佚名 2026-09-08 14:40:01

平时做技术实践时,很多问题不是概念不会,而是细节没串起来。拿“C#快速查找并高亮Word文档中的文字(普通查找+正则表达式)”来说,它看着像小点,放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际采用顺序,把思路、关键写法和容易踩坑的地方讲清楚,便于大家直接对照操作。

目录
  • 引言
  • 环境准备
  • 示例一:查找特定字符串并高亮
    • 核心代码逻辑
    • 完整代码
    • 代码解析
  • 示例二:采用正则表达式查找并高亮复杂模式
    • 场景描述
    • 核心代码逻辑
    • 完整代码
    • 正则表达式详解
    • 扩展思路
  • 常用问题与注意事项
    • 1. 命名空间引用
    • 2. 性能考量
  • 总结

    引言

    落到代码里,在日常办公自动化、文档审核或数据提取场景里,我们经常需在大量的 Word 文档中定位特定的关键词或符合某种模式的文本,同时将其高亮显示以便更快查阅。虽然 Microsoft Office Interop 能够完成这一功能,但它依赖本地安装的 Office 环境,且在服务器端运行时常遇到稳定性和权限问题。

    结合项目来看,事实上,在 C# 中,除了依赖本地 Office 的 Interop 方案外,还能够采用 Free Spire.Doc for .NET 这类免费独立组件来实现文本的查找与高亮功能。这种方式无需在运行环境中安装 Microsoft Word,适合服务器端或自动化场景。本文将借助两个具体示例,分别演示如何借助该库进行普通字符串查找正则表达式模式匹配的高亮实现。

    环境准备

    落到代码里,首先,你需在项目里引入 Free Spire.Doc 库。你能够借助 NuGet 包管理器安装:

    Install-Package FreeSpire.Doc

    或者从官方网站下载库文件,并手动添加引用。

    示例一:查找特定字符串并高亮

    实际处理时,假设我们有一份关于文学理论的 Word 文档 ( 输入.docx ),我们需找到其中所有的“超验主义”一词,同时将它们标记为黄色高亮。

    核心代码逻辑

    1. 加载 Word 文档。
    2. 采用 FindAllString 方法查找所有匹配项。
    3. 遍历结果,将每个匹配项的 HighlightColor 设置为黄色。
    4. 保存新文档。

    完整代码

    using System;
    using System.Drawing;
    using Spire.Doc;
    using Spire.Doc.Documents;

    namespace FindHighlightSimple
    {
        class Program
        {
            static void Main(string[] args)
            {
                // 1. 创建 Document 实例
                Document document = new Document();

                // 2. 加载示例 Word 文档
                // 请确保当前目录下存在 输入.docx 文件
                document.LoadFromFile("输入.docx");

                Console.WriteLine("正在查找文本 '超验主义' ...");

                // 3. 查找所有匹配的文本
                // 参数说明:
                // "超验主义": 要查找的字符串
                // false: 不区分大小写 (若为 true 则区分)
                // true: 全字匹配 (若为 true 则只匹配完整单词,避免匹配到包含该词的其他词)
                TextSelection[] textSelections = document.FindAllString("超验主义", false, true);

                Console.WriteLine($"共找到 {textSelections.Length} 处匹配项。");

                // 4. 遍历所有匹配项并设置高亮颜色
                foreach (TextSelection selection in textSelections)
                {
                    // GetAsOneRange() 将选区转换为一个文本范围对象
                    // CharacterFormat 允许我们修改字体、颜色、高亮等属性
                    selection.GetAsOneRange().CharacterFormat.HighlightColor = Color.Yellow;
                }

                // 5. 保存结果文件
                string outputPath = "高亮结果.docx";
                document.SaveToFile(outputPath, FileFormat.Docx);

                Console.WriteLine($"处理完成!结果已保存至:{outputPath}");
                
                // 可选:自动打开生成的文件
                // System.Diagnostics.Process.Start(outputPath);
            }
        }
    }

    代码解析

    • FindAllString : 这是 Spire.Doc 提供的最直接的查找方法。它得到一个 TextSelection 数组,每个元素代表文档中找到的一处匹配内容。
    • selection.GetAsOneRange() : 查找到的内容可能跨越多个段落或格式块,此方法将其视为一个连续的文本范围,便于统一设置格式。
    • CharacterFormat.HighlightColor : 直接调用 .NET 的 System.Drawing.Color 枚举来设置高亮色,兼容 Color.Red , Color.Green 等 Word 中的标准高亮颜色。

    示例二:采用正则表达式查找并高亮复杂模式

    实际处理时,在实际应用里,我们要查找的往往不是固定的字符串,而是符合某种规则的文本。比如,文档中包含许多类似 [Name] , [Date] , [ID_123] 这样的占位符,我们需将它们全部找出来同时高亮,以便后续替换或检查。

    落到代码里,这时,正则表达式(Regex)就派上用场了。Free Spire.Doc 兼容借助 FindAllPattern 方法进行正则匹配。

    场景描述

    我们需查找文档中所有格式为 [单词] 的占位符(比如 [Username] , [Address]),同时将它们高亮显示为绿色。

    核心代码逻辑

    1. 定义正则表达式 @[w+] 来匹配方括号内的单词。
    2. 采用 FindAllPattern 方法执行查找。
    3. 遍历结果,设置高亮颜色为绿色。

    完整代码

    using System;
    using System.Drawing;
    using System.Text.RegularExpressions;
    using Spire.Doc;
    using Spire.Doc.Documents;

    namespace FindHighlightRegex
    {
        class Program
        {
            static void Main(string[] args)
            {
                // 1. 创建 Document 实例
                Document document = new Document();

                // 2. 加载包含占位符的 Word 文档
                document.LoadFromFile("模板.docx");

                Console.WriteLine("正在使用正则表达式查找占位符...");

                // 3. 定义正则表达式
                // 解释:
                // [ : 匹配左方括号 '[' (需要转义)
                // w+ : 匹配一个或多个字母、数字或下划线
                // ] : 匹配右方括号 ']' (需要转义)
                Regex regex = new Regex(@"[w+]", RegexOptions.IgnoreCase);

                // 4. 查找所有符合正则模式的文本
                TextSelection[] selections = document.FindAllPattern(regex);

                Console.WriteLine($"共找到 {selections.Length} 个占位符。");

                // 5. 遍历并高亮
                foreach (TextSelection selection in selections)
                {
                    // 获取匹配到的具体文本内容,可用于日志记录或进一步处理
                    string matchedText = selection.GetAsOneRange().Text;
                    Console.WriteLine($" - 发现占位符: {matchedText}");

                    // 设置高亮颜色为浅绿色
                    selection.GetAsOneRange().CharacterFormat.HighlightColor = Color.LightGreen;
                    
                    // 进阶:同时也可以修改字体加粗,使其更明显
                    selection.GetAsOneRange().CharacterFormat.Bold = true;
                }

                // 6. 保存结果
                string outputPath = "正则高亮.docx";
                document.SaveToFile(outputPath, FileFormat.Docx);

                Console.WriteLine($"n处理完成!结果已保存至:{outputPath}");
            }
        }
    }

    正则表达式详解

    @"[w+]" :

    • @ 符号表示逐字字符串,避免反斜杠转义问题。
    • [] 分别匹配字符 []。因为在正则中方括号有特殊含义,所以需转义。
    • w+ 匹配中间的“单词”内容。
    • RegexOptions.IgnoreCase : 忽略大小写,这样 [NAME][name] 都能被匹配到。

    扩展思路

    你能够轻松修改正则表达式以适应更多场景:

    • 查找日期格式: @d{4}-d{2}-d{2} (匹配 2023-10-01)
    • 查找邮箱地址: @w+@w+.w+
    • 查找特定前缀的变量: @$[A-Za-z]+ (匹配 $Variable)

    常用问题与注意事项

    1. 命名空间引用

    确保你的文件头部包含了必要的引用:

    using Spire.Doc;
    using Spire.Doc.Documents;
    using System.Drawing; // 用于颜色
    using System.Text.RegularExpressions; // 用于正则

    2. 性能考量

    对于几百页的大型文档, FindAllStringFindAllPattern 的性能表现依然优秀。但如果在循环中进行大量其他复杂操作,建议先测试内存占用。

    总结

    在这个场景下,借助本文的两个示例,我们展示了如何借助 C# 和 Spire.Doc 库高效地处理 Word 文档中的文本高亮需求:

    1. 轻松查找:采用 FindAllString 更快定位固定关键词,适用来拼写检查、术语标记等场景。
    2. 正则查找:采用 FindAllPattern 配合正则表达式,灵活应对占位符、日期、邮箱等复杂模式的批量处理。

    实际处理时,这种方法完全摆脱了对 Microsoft Office 软件的依赖,代码简洁,运行稳定,很适合集成到 ASP.NET 后台服务、Windows 桌面应用或自动化脚本中。

    理解这一步时,以上就是C#更快查找同时高亮Word文档中的文字(普通查找+正则表达式)的详细内容,更多关于C#查找并高亮Word文字的资料请关注脚本之家其它相关文章!

    您可能感兴趣的文章:

    • 借助C#实现给Word文档添加文字和图片水印
    • C#实现给Word每一页设置不同文字水印的方法详解
    • C#设置Word文本框中改变文字方向的方法
    • C#生成Word文件(图片、文字)
    • C#采用OpenXml实现给word文档添加文字

    相关资讯
    点击查看更多
    游戏推荐
    推荐专题
    热门阅读
    推荐下载