把多份合同附件拼成一份完整文档、在报告末尾追加补充内容、或者把多个章节合并输出——这些需求在 Web 应用里并不少见。放到服务端处理,文件要先上传,离开用户的设备;让用户装桌面软件再手工拼接,又难以接入批量处理的 Web 流程。
本文用 Spire.Doc for JavaScript 在浏览器中直接合并 Word 文档。整个过程基于 WebAssembly 在浏览器端完成,无需安装 Office,也不依赖任何后端,文档通过虚拟文件系统(VFS)在本地读写,文件始终留在用户的设备上。
本文介绍两个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Doc for JavaScript。下面的示例假定 Spire.Doc 已安装、WebAssembly 模块已初始化。
以节为单位合并 Word 文档
Spire.Doc for JavaScript 通过 Sections.Add() 方法把一个节追加到目标文档末尾,配合 Section.Clone() 可以在不改动源文档的前提下复制节。克隆进来的节保留自身的页面设置,因此在合并后的文档中通常从新的一页开始。
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 将两份示例 Word 文档读入 VFS,创建
Document对象并加载目标文档。 - 再创建一个
Document对象,加载源文档。 - 遍历源文档的
Sections集合,使用Sections.Add(section.Clone())把每个节克隆并追加到目标文档末尾。 - 使用
Document.SaveToFile()方法保存结果文件。 - 从 VFS 读出结果文件并触发浏览器下载。
以节为单位合并 Word 文档的代码如下:
function App() {
const mergeBySection = async () => {
// 获取 Spire.Doc WASM 模块
const docModule = window.wasmModule?.spiredoc;
// 检查模块是否就绪
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
// 将两份示例文档读入 VFS
const inputFileName1 = 'Template_Docx_1.docx';
await window.spire.FetchFileToVFS(inputFileName1, '', `${process.env.PUBLIC_URL}static/data/`);
const inputFileName2 = 'Template_Docx_2.docx';
await window.spire.FetchFileToVFS(inputFileName2, '', `${process.env.PUBLIC_URL}static/data/`);
// 加载目标文档
const TarDoc = new docModule.Document();
TarDoc.LoadFromFile(inputFileName1);
// 加载源文档
const SouDoc = new docModule.Document();
SouDoc.LoadFromFile(inputFileName2);
// 将源文档的所有节克隆并追加到目标文档末尾
for (let i = 0; i < SouDoc.Sections.Count; i++) {
let section = SouDoc.Sections.get_Item(i);
TarDoc.Sections.Add(section.Clone());
}
// 定义输出文件名
const outputFileName = 'MergeBySection_out.docx';
// 保存合并后的文档
TarDoc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
// 从 VFS 读取合并后的文件,触发下载
const modifiedFileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([modifiedFileArray], { 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);
// 释放资源
TarDoc.Dispose();
SouDoc.Dispose();
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>以节为单位合并 Word 文档</h1>
<button onClick={mergeBySection}>
合并文档
</button>
</div>
);
}
export default App;
以节为单位合并 Word 文档后,源文档的每个节在目标文档中独立成页:

只合并源文档中的指定节
如果只需要源文档里的某几个节,不必遍历整个 Sections 集合,按索引取出目标节再克隆即可:
// 只克隆源文档的第 1 个节,追加到目标文档末尾
const section = SouDoc.Sections.get_Item(0);
TarDoc.Sections.Add(section.Clone());
在同一页合并 Word 文档
在同一页合并与以节为单位合并的区别在于:它不为源文档新建节,而是把源文档中的段落、表格、图片等元素逐一克隆,追加到目标文档的同一个节里。两种方式对应的 API 如下:
| 写法 | 追加的内容 | 分页 |
|---|---|---|
Sections.Add(section.Clone()) |
源文档的一个完整节 | 每个节从新的一页开始 |
Body.ChildObjects.Add(obj.Clone()) |
源文档节中的一个内容元素 | 内容连续排列,不新建节 |
具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 将两份示例 Word 文档读入 VFS,创建
Document对象并加载目标文档。 - 记下目标文档当前的节数,用于定位最后一个节。
- 再创建一个
Document对象加载源文档,双层遍历其中每个节的Body.ChildObjects。 - 使用
ChildObjects.Add(obj.Clone())把每个内容元素追加到目标文档最后一个节的ChildObjects末尾。 - 使用
Document.SaveToFile()方法保存结果文件。 - 从 VFS 读出结果文件并触发浏览器下载。
在同一页合并 Word 文档的代码如下:
function App() {
const mergeOnSamePage = async () => {
// 获取 Spire.Doc WASM 模块
const docModule = window.wasmModule?.spiredoc;
// 检查模块是否就绪
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
// 将两份示例文档读入 VFS
const inputFileName1 = 'Template_Docx_1.docx';
await window.spire.FetchFileToVFS(inputFileName1, '', `${process.env.PUBLIC_URL}static/data/`);
const inputFileName2 = 'Template_Docx_2.docx';
await window.spire.FetchFileToVFS(inputFileName2, '', `${process.env.PUBLIC_URL}static/data/`);
// 加载目标文档
const destinationDocument = new docModule.Document();
destinationDocument.LoadFromFile(inputFileName1);
// 记下目标文档当前的节数
let count = destinationDocument.Sections.Count;
// 加载源文档
const doc = new docModule.Document();
doc.LoadFromFile(inputFileName2);
// 遍历源文档的所有内容元素,克隆到目标文档的最后一个节中
for (let i = 0; i < doc.Sections.Count; i++) {
let section = doc.Sections.get_Item(i);
for (let j = 0; j < section.Body.ChildObjects.Count; j++) {
let obj = section.Body.ChildObjects.get_Item(j);
destinationDocument.Sections.get_Item(count - 1).Body.ChildObjects.Add(obj.Clone());
}
}
// 定义输出文件名
const outputFileName = 'MergeOnSamePage_out.docx';
// 保存合并后的文档
destinationDocument.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
// 从 VFS 读取合并后的文件,触发下载
const modifiedFileArray = window.dotnetRuntime.Module.FS.readFile(outputFileName);
const blob = new Blob([modifiedFileArray], { 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);
// 释放资源
destinationDocument.Dispose();
doc.Dispose();
};
return (
<div style={{ textAlign: 'center', height: '300px' }}>
<h1>在同一页合并 Word 文档</h1>
<button onClick={mergeOnSamePage}>
合并文档
</button>
</div>
);
}
export default App;
在同一页合并 Word 文档后,源文档的内容连续追加到目标文档的最后一个节中,不产生分页:

常见问题
合并后的文件会上传到服务器吗
不需要。Spire.Doc for JavaScript 基于 WebAssembly 在浏览器端运行,文档通过虚拟文件系统(VFS)在本地读写,合并、保存都在本地完成,库本身不会把文件发往服务器。文件最终是否会离开设备,取决于你在页面上另外接入的代码。
可以一次合并多个 Word 文档吗
可以,循环处理即可:把每个源文档依次加载,以节为单位合并 Word 文档时对每个源文档的每个节调用 Sections.Add(section.Clone());在同一页合并 Word 文档时,对每个源文档循环克隆 Body.ChildObjects。文档数量较多时留意浏览器内存,用完及时调用 Dispose() 释放 Document 对象。
以节为单位合并后,源文档内容为什么从新的一页开始
原因:Section.Clone() 复制的是完整的节,节中包含自己的页面设置。追加到目标文档后,合并进来的内容通常从新的一页开始。
解决:需要内容连续排列时,改用在同一页合并 Word 文档,把源文档的段落、表格等元素逐个追加到目标文档的最后一个节:
// 以元素为单位追加,不新建节
destinationDocument.Sections.get_Item(count - 1).Body.ChildObjects.Add(obj.Clone());
合并后的 Word 文档打不开怎么办
原因:保存格式与文件扩展名不一致,或者下载时 Blob 的 MIME 类型与文件实际格式不匹配,浏览器或 Word 可能无法正确识别文件。
解决:让保存格式、扩展名和 MIME 类型保持一致。SaveToFile() 的 fileFormat 使用 Docx2013 时,输出文件名保留 .docx 扩展名,Blob 的 type 使用对应的 DOCX 类型:
const blob = new Blob([fileArray], {
type: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'
});
合并后图片和表格会保留吗
一般会保留。以节为单位合并 Word 文档时克隆的是整个节;在同一页合并 Word 文档时克隆的是节 Body 下的段落、表格等子对象,这些内容会随克隆一起写入目标文档,段落中的图片通常也会一并保留。合并后建议打开结果文件检查版式。
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







