合同条款里的 §、商标说明里的 ™、技术文档里的 α 与 ∑,通常不在常规键盘上,也不一定能用输入法直接打出。批量生成文档时,这些符号需要由程序写入;清理模板残留时,又要能准确删掉,而不是误伤正文。
本文用 Spire.Doc for JavaScript 在浏览器中完成符号的写入与清理。整个过程基于 WebAssembly 在浏览器端进行,不需要安装 Office,也不依赖后端服务,文档始终留在用户的设备上。
本文介绍三个核心功能点:
有关安装和项目配置,请参考 React 项目中集成 Spire.Doc for JavaScript。下面的示例假定 Spire.Doc 已安装、WebAssembly 模块已初始化。
在 Word 段落中插入特殊符号
在 Word 段落中插入特殊符号时,符号最终都是字符,区别在于用什么字体、以什么方式写入。普通标点可以直接作为文字写入;数学符号与希腊字母往往依赖 Symbol 字体,需要按字体中的字符位置写入。
| 写入方式 | 调用 | 适用符号 |
|---|---|---|
| 作为普通文字写入 | paragraph.AppendText('©') |
标点、货币、版权与商标符号 |
| 按字符位置写入 | paragraph.AppendSymbol(code) |
Symbol 字体中的数学、希腊、箭头符号 |
| 修改已有文字的字体 | textRange.CharacterFormat.FontName = 'Symbol' |
把已有字符映射到符号字体 |
文中的示例使用 Notice.docx。这份通知包含页眉、参数表、合同条款与符号索引,正文中分布着 §、™、®、α、∑ 等符号:

具体操作步骤如下:
- 获取 Spire.Doc 的 WASM 模块,确认已就绪。
- 把中文字体与示例文档
Notice.docx载入 VFS。 - 创建
Document对象并加载文档,取第一节,在末尾添加一个段落。 - 用
AppendText写入版权行与公式文本,用SubSuperScript把平方写成上标。 - 保存为
NoticeWithSymbols.docx,从 VFS 读出文件并触发浏览器下载。
插入特殊符号的代码如下:
function App() {
const addSymbols = async () => {
// 获取 Spire.Doc 的 WASM 模块
const docModule = window.wasmModule?.spiredoc;
if (!docModule) {
alert('Spire.Doc is not ready yet');
return;
}
// 载入示例文档
await window.spire.FetchFileToVFS('Notice.docx', '', `${process.env.PUBLIC_URL}/data/`);
const doc = new docModule.Document();
doc.LoadFromFile('Notice.docx');
const section = doc.Sections.get_Item(0);
const paragraph = section.AddParagraph();
// 普通符号:直接作为文字写入
const copyright = paragraph.AppendText('Copyright © 2026 明远科技有限公司');
copyright.CharacterFormat.FontSize = 10.5;
paragraph.AppendText('\r\n');
// 公式:π 直接写入,平方用上标实现
const formula = paragraph.AppendText('面积 S = πr');
formula.CharacterFormat.FontSize = 10.5;
const square = paragraph.AppendText('2');
square.CharacterFormat.SubSuperScript = docModule.SubSuperScript.SuperScript;
const tail = paragraph.AppendText(',当 r = 12.5 cm 时,S ≈ 491 cm²。');
tail.CharacterFormat.FontSize = 10.5;
const outputFileName = 'NoticeWithSymbols.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={addSymbols}>插入</button>
</div>
);
}
export default App;
新增的版权行与公式位于文档末尾:

按字符位置插入 Symbol 字体符号
AppendSymbol 接收一个字符位置,并生成使用 Symbol 字体的 Symbol 对象。下面的写法在段落末尾插入 α 与 ∑:
// Symbol 字体中,0x61 对应 α,0xE5 对应 ∑
const alpha = paragraph.AppendSymbol(0x61);
alpha.FontName = 'Symbol';
alpha.CharacterFormat.FontSize = 12;
const sum = paragraph.AppendSymbol(0xE5);
sum.FontName = 'Symbol';
sum.CharacterFormat.FontSize = 12;
不同字体对同一代码值的映射可能不同,插入后建议在 Word 中确认字形。如果显示结果与预期不符,可以改用 AppendText 直接写入 Unicode 字符,再设置覆盖范围更大的字体。
符号显示异常时先检查字体
方框通常表示当前字体缺少该字形。Symbol 字体只覆盖特定字符集,部分中文字体也不包含完整的数学符号。可以依次尝试以下做法:
- 把
CharacterFormat.FontName改为Cambria Math、Segoe UI Symbol或Arial Unicode MS等覆盖范围更大的字体; - 用
AppendText写入 Unicode 字符,避免依赖字体的私有位置; - 对必须保持固定外观的符号,改用图片或嵌入字体。
单纯放大字号一般不会让缺失的字形出现。
按文本删除 Word 文档中的特殊符号
按文本删除 Word 文档中的特殊符号时,使用 Paragraph.Replace():在段落内查找指定字符串并替换。把替换内容设为空字符串,就得到删除效果。它适合清理模板里的占位标记,例如统一去掉条款编号前的 §。
| 参数 | 含义 | 示例取值 |
|---|---|---|
given |
要查找的文本 | '§' |
replace |
替换成的文本 | ''(空字符串即删除) |
caseSensitive |
是否区分大小写 | false |
wholeWord |
是否只匹配整词 | false |
Replace() 只作用于调用它的那个段落,因此需要先遍历文档中的段落。
具体操作步骤如下:
- 载入示例文档
Notice.docx。 - 遍历所有节,再遍历每节的
Body.ChildObjects。 - 跳过非段落对象,对段落调用
Replace('§', '', false, false)与Replace('™', '', false, false)。 - 保存为
NoticeWithoutSymbols.docx。 - 从 VFS 读出结果并下载。
按文本删除特殊符号的代码如下(省略了与上一节相同的模块检查、字体载入与下载代码):
const doc = new docModule.Document();
doc.LoadFromFile('Notice.docx');
for (let s = 0; s < doc.Sections.Count; s++) {
const section = doc.Sections.get_Item(s);
const body = section.Body;
for (let i = 0; i < body.ChildObjects.Count; i++) {
const obj = body.ChildObjects.get_Item(i);
if (obj.DocumentObjectType !== docModule.DocumentObjectType.Paragraph) continue;
// 第二个参数为空字符串,表示把匹配到的符号直接删除
obj.Replace('§', '', false, false);
obj.Replace('™', '', false, false);
}
}
const outputFileName = 'NoticeWithoutSymbols.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
上面的循环覆盖正文顶层的段落。如果符号位于表格单元格,需要继续遍历 Table.Rows、Row.Cells,再对单元格内的段落调用 Replace();也可以直接对 Document 调用同样签名的 Replace()。
删除前后的合同条款对比如下,条款编号前的 § 被移除,编号与正文保留。同一轮循环也会清除正文中的 ™:

一次删除多种符号
把目标符号放进数组,循环调用 Replace():
const targets = ['§', '™', '®', '©'];
for (const symbol of targets) {
paragraph.Replace(symbol, '', false, false);
}
这样会删除段落内所有匹配项。如果 ©、® 在正文中有实际含义,不要把它们加入列表,只保留确实需要清理的占位符号。
按对象精确删除 Word 文档中的特殊符号
按对象精确删除 Word 文档中的特殊符号,适合只想删掉某一个位置、又要保留其他地方同名符号的场景。做法是遍历段落的 ChildObjects,找到文字内容等于目标符号的 TextRange,再用 RemoveAt(index) 移除。按文本删除的范围则是整个段落,段落里所有同名符号都会被清除。
| 方式 | 调用 | 删除范围 | 适用场景 |
|---|---|---|---|
| 按文本删除 | Paragraph.Replace() |
段落内所有匹配 | 模板占位符、统一清理 |
| 按对象删除 | ChildObjects.RemoveAt(index) |
指定的 TextRange |
保留正文中的同名符号 |
具体操作步骤如下:
- 载入示例文档
Notice.docx。 - 遍历所有节与正文段落。
- 倒序遍历段落的
ChildObjects。 - 判断对象类型为
TextRange且Text等于'™'时,调用RemoveAt(k)。 - 保存为
NoticeWithoutTrademark.docx并下载。
按对象删除特殊符号的代码如下:
const doc = new docModule.Document();
doc.LoadFromFile('Notice.docx');
const target = '™'; // 只删除商标符号,保留正文中的其他字符
for (let s = 0; s < doc.Sections.Count; s++) {
const section = doc.Sections.get_Item(s);
const body = section.Body;
for (let i = 0; i < body.ChildObjects.Count; i++) {
const paragraph = body.ChildObjects.get_Item(i);
if (paragraph.DocumentObjectType !== docModule.DocumentObjectType.Paragraph) continue;
// 必须倒序遍历:删除元素后,后续元素的下标会前移
for (let k = paragraph.ChildObjects.Count - 1; k >= 0; k--) {
const child = paragraph.ChildObjects.get_Item(k);
const isText = child.DocumentObjectType === docModule.DocumentObjectType.TextRange;
if (isText && child.Text === target) {
paragraph.ChildObjects.RemoveAt(k);
}
}
}
}
const outputFileName = 'NoticeWithoutTrademark.docx';
doc.SaveToFile({ fileName: outputFileName, fileFormat: docModule.FileFormat.Docx2013 });
doc.Dispose();
删除前后的商标符号对比如下,只有 ™ 被移除,® 与其他文字保持不变:

为什么要倒序遍历 ChildObjects
RemoveAt() 删除元素后,后面的元素会整体前移一位。正序遍历时,每删除一个元素,下一次循环就会跳过一个;倒序遍历不会受下标前移影响。这是删除集合元素时常用的写法。
// 从最后一个元素开始,删除后不影响尚未处理的元素
for (let k = paragraph.ChildObjects.Count - 1; k >= 0; k--) {
const child = paragraph.ChildObjects.get_Item(k);
// 判断并删除
}
按对象删除会带走整段文字吗
只会移除被选中的 TextRange。如果符号单独位于一个 TextRange 中,删除后同一段落的其他文字不受影响;如果符号和正文被合并进同一个 TextRange,RemoveAt() 会把该区间一起删掉。遇到后者,可以先拆分文字区间,或改用 Replace() 精确替换符号本身。
表格单元格本身也是 Body。符号位于表格中时,需要先遍历 Table.Rows 与 Row.Cells,再对单元格内的段落做同样的 TextRange 判断。
常见问题
插入的符号为什么显示成方框
方框通常说明当前字体没有对应的字形。可以换用 Cambria Math、Segoe UI Symbol 等覆盖面更广的字体,或直接用 AppendText 写入 Unicode 字符。若替换字体后仍显示异常,可以检查文档打开环境是否安装了该字体。
AppendSymbol 的代码值可以直接填 Unicode 码位吗
一般不可以。AppendSymbol() 的代码值对应字体中的字符位置,不同字体对同一数值的映射可能不同;Unicode 码位则以字符本身为准。拿不准映射关系时,用 AppendText 写入实际字符通常更稳妥。
用 Replace 删除符号,为什么正文里的同名符号也被删了
Paragraph.Replace() 的处理范围是整个段落,段落内所有匹配都会替换。若只想删掉其中一处,可以改用按对象删除,先定位对应的 TextRange,再调用 RemoveAt();也可以先用 FindAllString() 取得匹配区间,再逐一处理。
删除多个符号时,为什么会漏删
如果按对象删除并且在循环里使用递增下标,每删一个元素,后面的元素都会前移,容易跳过目标。把循环改成从 ChildObjects.Count - 1 开始递减,通常可以避免漏删。
这些操作需要把 Word 文件上传到服务器吗
本文的用法不需要上传。Spire.Doc for JavaScript 基于 WebAssembly 在浏览器端运行,文档通过虚拟文件系统(VFS)在本地读写,插入、删除与保存都在本地完成,库本身不会把文件发往服务器。文件最终是否离开设备,取决于页面中另外接入的代码。
获取免费许可证
如果您希望删除结果文档中的评估消息,或者摆脱功能限制,请该Email地址已收到反垃圾邮件插件保护。要显示它您需要在浏览器中启用JavaScript。获取有效期 30 天的临时许可证。







