校稿时最费时的不是改,而是先找:合同里的“违约金”散落在四五个条款里,报告里的日期写法各不相同,附录里的英文术语又要求统一大写。逐处人工标记容易漏,拿服务端脚本批处理,文件就先离开了用户的设备。
本文用 Spire.Doc for JavaScript 在浏览器中完成查找、替换与大小写调整。整个过程基于 WebAssembly 在浏览器端运行,无需安装 Office,也不依赖后端,文档始终留在用户的设备上。
本文介绍三个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Doc for JavaScript。下面的示例假定 Spire.Doc 已安装、WebAssembly 模块已初始化。
示例合同共 2 页:正文含 4 处“违约金”、10 处 YYYY-MM-DD 格式的日期(共 4 种写法),附录 A 列出 4 组英文术语。三个功能点都基于这一份文件:

三个功能点都从同一套对象出发:
| 调用 | 返回 | 用途 |
|---|---|---|
document.FindAllString(text, caseSensitive, wholeWord) |
TextSelection 集合 |
按纯文本查找全部命中 |
document.FindAllPattern(regex) |
TextSelection 集合 |
按正则查找全部命中 |
selection.GetRanges() |
TextRange 集合 |
命中文字覆盖的字符区间 |
range.CharacterFormat |
CharacterFormat |
高亮、大小写等字符格式 |
document.Replace(text, replacement, caseSensitive, wholeWord) |
替换处数 | 全文按纯文本替换 |
查找并高亮 Word 文档中的关键词
查找并高亮 Word 文档中的关键词,是审阅阶段最安全的一步:只改字符背景色,不动文字内容,标记错了去掉颜色即可。FindAllString() 在整篇文档中查找关键词,每个命中是一个 TextSelection,再由 GetRanges() 取出它所覆盖的字符区间。
| 参数或成员 | 作用 |
|---|---|
text |
要查找的文字,如 '违约金' |
caseSensitive |
是否区分大小写,示例传 false |
wholeWord |
是否只匹配完整单词,示例传 false |
selection.SelectedText |
命中的原始文字 |
range.CharacterFormat.HighlightColor |
高亮颜色,接收 Color 对象 |
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 读入示例合同文档,创建
Document对象并加载该文件。 - 使用
Document.FindAllString()方法查找关键词,得到全部命中。 - 遍历命中,用
GetRanges()取出字符区间,设置CharacterFormat.HighlightColor。 - 使用
Document.SaveToFile()方法保存结果文件,从 VFS 读出并触发浏览器下载。
查找并高亮 Word 文档中的关键词的代码如下:
function App() {
const highlightKeywords = async () => {
// 获取 Spire.Doc WASM 模块
const docModule = window.wasmModule?.spiredoc;
// 检查模块是否就绪
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
// 载入示例合同
await window.spire.FetchFileToVFS('Contract.docx', '', `${process.env.PUBLIC_URL}/data/`);
// 创建 Document 实例并加载合同
const doc = new docModule.Document();
doc.LoadFromFile('Contract.docx');
// 黄色高亮
const yellow = docModule.Color.FromArgb(255, 255, 235, 59);
// 文档级查找:正文、表格、页眉页脚一并覆盖
const hits = doc.FindAllString('违约金', false, false);
for (const selection of hits) {
// 一个命中可能跨越多个字符区间,逐个区间上色
const ranges = selection.GetRanges();
for (const range of ranges) {
range.CharacterFormat.HighlightColor = yellow;
}
}
// 保存结果文件
const outputFileName = 'Highlighted.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], { type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>查找并高亮</h1>
<button onClick={highlightKeywords}>
高亮关键词
</button>
</div>
);
}
export default App;
4 处“违约金”都被标记为黄色,文字内容没有变化:

高亮会改变文字内容吗
不会。HighlightColor 属于字符格式,写入的是段落 run 上的高亮属性,SelectedText 读到的仍是原来的文字。
也正因为如此,高亮对“文字是否被改过”这件事不敏感:后续用 Replace() 改掉这段文字时,替换进来的新文字通常不再带高亮。想让标记保留到修改之后,就在替换完成后再查找一次、重新上色。
表格与页眉页脚里的关键词
本文用的是文档级查找 Document.FindAllString(),它遍历的范围包含正文、表格单元格、页眉和页脚,因此表格里的“违约金”同样会被标记。
如果改成逐段遍历,对从 Section.Body.ChildObjects 取出的段落对象调用段落级查找,在本示例的构建中会抛 Arg_NullReferenceException。需要按段落处理时,先用 FindAllString() 拿到命中,再通过 selection.GetRanges() 定位,比自行遍历段落稳定。
使用正则表达式查找与替换 Word 文本
使用正则表达式查找与替换 Word 文本,适合处理有规律、但写法不统一的内容:日期、编号、金额、旧产品名。固定字符串只能匹配一种写法,正则可以先圈出全部候选,再决定怎么改。
示例合同里的日期都是 2026-11-09 这样的形式,需要统一改成“2026 年 11 月 9 日”。全文共 10 处,去重后其实只有 4 种写法。
| 成员 | 作用 |
|---|---|
new docModule.Regex(pattern) |
构造正则表达式对象 |
document.FindAllPattern(regex) |
按正则查找全部命中 |
selection.SelectedText |
命中的原始文字,可用于去重 |
document.Replace(text, replacement, caseSensitive, wholeWord) |
按纯文本全文替换,返回替换处数 |
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 读入示例合同,创建
Document对象并加载该文件。 - 使用
Document.FindAllPattern()方法配合Regex('\\d{4}-\\d{2}-\\d{2}')找出全部日期。 - 把命中的原始文字收进
Set去重,逐个调用Document.Replace()换成“年 月 日”写法,并累加返回的替换处数。 - 使用
Document.SaveToFile()方法保存结果文件,从 VFS 读出并触发浏览器下载。
使用正则表达式查找与替换 Word 文本的代码如下:
function App() {
const replaceDates = async () => {
// 获取 Spire.Doc WASM 模块
const docModule = window.wasmModule?.spiredoc;
// 检查模块是否就绪
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
// 载入示例合同
await window.spire.FetchFileToVFS('Contract.docx', '', `${process.env.PUBLIC_URL}/data/`);
// 创建 Document 实例并加载合同
const doc = new docModule.Document();
doc.LoadFromFile('Contract.docx');
// 匹配形如 2026-11-09 的日期
const datePattern = new docModule.Regex('\\d{4}-\\d{2}-\\d{2}');
const matches = doc.FindAllPattern(datePattern);
// 收集命中的原始文字并去重:同一日期在文中出现多次
const found = new Set();
for (const selection of matches) {
found.add(selection.SelectedText);
}
// 逐个替换:一次 Replace 会改掉全文所有相同写法
let replaced = 0;
for (const text of found) {
const [year, month, day] = text.split('-');
replaced += doc.Replace(
text,
`${year} 年 ${Number(month)} 月 ${Number(day)} 日`,
false,
true
);
}
console.log(`命中 ${matches.length} 处,写法 ${found.size} 种,替换 ${replaced} 处`);
// 保存结果文件
const outputFileName = 'DatesReplaced.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], { type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>正则替换</h1>
<button onClick={replaceDates}>
统一日期写法
</button>
</div>
);
}
export default App;
日期统一替换为“年 月 日”写法后的合同(第 1 页):

为什么分组替换没有生效
Document.Replace(regex, replacement) 可以接受 Regex 对象,但它不会展开 $1、$2 这样的分组引用。直接传 '$1 年 $2 月 $3 日',文档里写进去的就是这串字符本身:
// 结果是字面量 “$1 年 $2 月 $3 日”,不是 2026 年 11 月 9 日
doc.Replace(new docModule.Regex('(\\d{4})-(\\d{2})-(\\d{2})'), '$1 年 $2 月 $3 日');
所以先用 FindAllPattern() 把命中的原文字取出来,在 JavaScript 里拼好新文字,再用 Replace() 按纯文本替换,这正是上面代码分成两步的原因。
正则模式里要写几个反斜杠
Regex 的构造参数是字符串,先经过 JavaScript 字符串转义,再交给正则引擎解析。想要正则里的 \d,字符串里就得写成 '\\d';\s、\w、\. 同理。写成 '\d' 时,字符串里只剩下字母 d,正则引擎收到的模式中已经没有反斜杠,匹配结果自然不对。
将 Word 中的英文文本改为全部大写
将 Word 中的英文文本改为全部大写,常用在附录术语、缩写和编号上。CharacterFormat.AllCaps 只改变显示效果,文档里保存的仍是原始大小写——处理附录 A 这类“看起来要大写”的排版要求,改格式比改文字更省事,也更容易回退。
全文用 [A-Za-z]+ 可以匹配到 20 处英文单词,包括合同编号、设备型号和附录里的术语:
| 成员 | 作用 |
|---|---|
new docModule.Regex('[A-Za-z]+') |
匹配连续的英文字母 |
range.CharacterFormat.AllCaps |
显示为全部大写,内容不变 |
range.CharacterFormat.IsSmallCaps |
显示为小型大写字母 |
document.Replace(text, text.toUpperCase(), ...) |
真正改写文字内容 |
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 读入示例合同与字体,创建
Document对象并加载该文件。 - 使用
Document.FindAllPattern()方法配合Regex('[A-Za-z]+')找出全部英文单词。 - 遍历命中,取出字符区间并设置
CharacterFormat.AllCaps = true。 - 使用
Document.SaveToFile()方法保存结果文件,从 VFS 读出并触发浏览器下载。
将 Word 中的英文文本改为全部大写的代码如下:
function App() {
const uppercaseEnglish = async () => {
// 获取 Spire.Doc WASM 模块
const docModule = window.wasmModule?.spiredoc;
// 检查模块是否就绪
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
// 载入示例合同
await window.spire.FetchFileToVFS('Contract.docx', '', `${process.env.PUBLIC_URL}/data/`);
// 创建 Document 实例并加载合同
const doc = new docModule.Document();
doc.LoadFromFile('Contract.docx');
// 找出全部英文单词
const words = doc.FindAllPattern(new docModule.Regex('[A-Za-z]+'));
for (const selection of words) {
const ranges = selection.GetRanges();
for (const range of ranges) {
// 显示为全部大写,原始内容保持不变
range.CharacterFormat.AllCaps = true;
}
}
// 保存结果文件
const outputFileName = 'Uppercase.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
// 从 VFS 读取生成的文件,触发下载
const fileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([fileArray], { type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' });
const url = URL.createObjectURL(blob);
const a = document.createElement('a');
a.href = url;
a.download = outputFileName;
a.click();
URL.revokeObjectURL(url);
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>英文全部大写</h1>
<button onClick={uppercaseEnglish}>
转为大写
</button>
</div>
);
}
export default App;
附录中的英文术语设置为全部大写后的显示效果(第 2 页):

显示大写与内容大写的区别
AllCaps 是字符格式,效果等同于在 Word 里勾选“全部大写”:屏幕上显示为大写,文字本身没变,复制成纯文本再粘贴,拿到的仍是 product specification。
需要让文字参与检索、比对或导出,就要改内容本身:
// 内容级转换:文档里存的就是大写,复制出去也是大写
doc.Replace('product specification', 'PRODUCT SPECIFICATION', false, true);
两种方式可以配合:先按内容替换确定要改的词,再用 AllCaps 统一露出的样式。
小型大写字母的适用场景
IsSmallCaps 把英文显示为小型大写字母,首字母略高、其余字母按小字号的形态呈现,常见于作者署名和缩写。设置方式与 AllCaps 相同:
const paragraph = doc.Sections.get_Item(0).AddParagraph();
// 显示为小型大写字母
const smallCaps = paragraph.AppendText('Appendix');
smallCaps.CharacterFormat.IsSmallCaps = true;
同一段文字上同时设置两个属性时,最终效果取决于渲染方的解释,混用前先在目标阅读器里预览一遍。
三个功能点的处理顺序
| 步骤 | 目的 | 是否改变内容 |
|---|---|---|
| 查找并高亮 | 标记待处理位置 | 否 |
| 正则替换 | 统一写法 | 是 |
| 转为全部大写 | 调整显示形式 | 否(AllCaps)/ 是(Replace) |
建议先高亮确认范围,再执行替换,最后处理大小写。这样每一步看到的都是同一版原文:高亮标出的位置,正是接下来要改的地方。先替换再回头补标记,找到的已经是对改过的文字,审阅记录和原文就对不上了。
常见问题
需要把 Word 文档上传到服务器吗
本文的用法不需要上传。Spire.Doc for JavaScript 基于 WebAssembly 在浏览器端运行,文档通过虚拟文件系统(VFS)在本地读写,查找、替换、保存都在本地完成,库本身不会把文件发往服务器。文件最终是否会离开设备,取决于你在页面上另外接入的代码。
查找会覆盖表格、页眉和页脚里的内容吗
用文档级方法(Document.FindAllString()、Document.FindAllPattern())时,表格单元格、页眉和页脚都在查找范围内,这一点已用带关键词页眉的样张验证过。
段落级查找的覆盖范围取决于对象的来源:对从 Section.Body.ChildObjects 取出的段落直接调用 FindAllString(),在本示例的构建中会抛 Arg_NullReferenceException。需要限定范围时,更稳妥的做法是先做文档级查找,再按 selection.GetRanges() 的结果处理。
为什么查找结果不能直接调用 map()
FindAllString() 和 FindAllPattern() 返回的是 .NET 集合的代理对象,不是 JavaScript 数组。它支持 length、下标取值和 for...of 迭代,但没有 map()、filter() 这些数组方法。
需要数组方法时先转换一次:
const hits = doc.FindAllString('违约金', false, false);
// 转成真正的 JavaScript 数组,之后可以使用 map / filter / reduce
const list = Array.from(hits);
全大写的英文复制到其他软件后为什么变回小写
因为 AllCaps 是显示层属性,写在字符格式里,文字本身没有变化。复制为纯文本时,接收方拿到的只有字符内容,格式被丢弃,于是又回到原来的大小写。
希望复制出去也是大写,就得改写内容,例如用 Document.Replace() 把原文替换成 text.toUpperCase() 的结果。
同一个日期出现多次,需要逐个位置替换吗
不需要。Document.Replace() 一次调用会改掉全文所有相同写法的文字,返回值就是本次替换的处数。示例里 2026-11-09 出现 4 次,调用一次就返回 4。
真正需要改的其实只是“有几种写法”,所以先用 FindAllPattern() 找到命中、用 Set 去重,再对每种写法各调用一次即可,10 处日期只需要 4 次替换。
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







