纯Java实现Word中常见的编辑功能

在日常的企业级应用开发中，Word 文档的自动化处理几乎是绕不开的需求。人工手动编辑当然能搞定，可一旦涉及批量处理、系统集成，用 Ja va 代码来动态操作文档才是正解——效率高、可重复性强，还不会累。 下面要聊的是一个纯 Ja va 实现的 Word 文档操作库，配合具体代码示例，看看怎么搞定文本替换、格式调整、内容增删这些常见的编辑任务。关键是，这套方案不依赖本地的 Office 环境，换句话说，部署到 Linux 服务器上也能跑，省心不少。 ## 1. 环境准备与依赖引入 动手编码之前，先把依赖加到项目里。项目用的是 Ma ven，那就直接在 `pom.xml` 里加上仓库和依赖： ```xml com.e-iceblue e-iceblue https://repo.e-iceblue.cn/repository/ma ven-public/ e-iceblue spire.doc 14.6.0 ``` 如果项目不是 Ma ven 管理的，手动下载 JAR 包然后加到 Build Path 里也行。 ## 2. 核心操作：编辑文档内容 这个库把 Word 文档抽象成一套分层对象模型。一个文档由若干个 `Section`（节）组成，每个节里又包含多个 `Paragraph`（段落），段落里则藏着文本、图片等元素。理解了这个结构，操作起来就清晰了。 ### 2.1 修改指定文本 改文本是最基础的操作。先定位到具体的段落，然后用 `setText` 方法替换内容。 下面这段代码演示了怎么加载一个已有的 Word 文档，然后修改第一个段落里的文本： ```ja va import com.spire.doc.Document; import com.spire.doc.FileFormat; import com.spire.doc.Section; import com.spire.doc.documents.Paragraph; public class ModifyText { public static void main(String[] args) { Document document = new Document(); document.loadFromFile("原文档.docx"); Section section = document.getSections().get(0); Paragraph paragraph = section.getParagraphs().get(0); paragraph.setText("【新】这是一个被Ja va代码修改过的标题。"); document.sa veToFile("编辑后的文档.docx", FileFormat.Docx); document.dispose(); } } ``` ### 2.2 格式化文本样式 只改文字还不够，实际开发里经常要调整字体、颜色、粗细这些样式。在这个库中，文本通常以 `TextRange` 对象的形式存在。遍历段落里的子对象，找到 `TextRange` 后修改它的 `CharacterFormat` 属性就行。 看这个例子——把特定段落的字体设为微软雅黑、蓝色、斜体，字号也调大： ```ja va import com.spire.doc.Document; import com.spire.doc.Section; import com.spire.doc.documents.Paragraph; import com.spire.doc.fields.TextRange; import ja va.awt.*; public class FormatText { public static void main(String[] args) { Document document = new Document(); document.loadFromFile("样例文档.docx"); Paragraph paragraph = document.getSections().get(0).getParagraphs().get(1); for (int i = 0; i < paragraph.getChildObjects().getCount(); i++) { Object obj = paragraph.getChildObjects().get(i); if (obj instanceof TextRange) { TextRange textRange = (TextRange) obj; textRange.getCharacterFormat().setFontName("微软雅黑"); textRange.getCharacterFormat().setFontSize(14); textRange.getCharacterFormat().setTextColor(Color.BLUE); textRange.getCharacterFormat().setItalic(true); } } document.sa veToFile("格式化后的文档.docx", FileFormat.Docx); document.dispose(); } } ``` ### 2.3 添加新内容（文本与图片） 除了修改，追加内容也是高频操作。`Section.addParagraph()` 用来新增段落，`Paragraph.appendText()` 和 `Paragraph.appendPicture()` 则负责往段落里塞文字和图片。 下面这段代码展示了如何追加一段文字（图片的部分也给了示例，生产环境记得先检查图片路径是否存在）： ```ja va import com.spire.doc.Document; import com.spire.doc.Section; import com.spire.doc.documents.Paragraph; public class AddContent { public static void main(String[] args) { Document document = new Document(); document.loadFromFile("原文档.docx"); Section lastSection = document.getLastSection(); Paragraph newParagraph = lastSection.addParagraph(); newParagraph.appendText("这是由Ja va程序自动追加的文字说明。"); // newParagraph.appendPicture("C:\\images\\logo.png"); document.sa veToFile("新增内容后的文档.docx", FileFormat.Docx); document.dispose(); } } ``` ### 2.4 删除指定段落 删除操作更直接——获取 `Paragraph` 集合后调用 `removeAt`，传入索引就行。 ```ja va import com.spire.doc.Document; import com.spire.doc.Section; public class RemoveContent { public static void main(String[] args) { Document document = new Document(); document.loadFromFile("原文档.docx"); Section section = document.getSections().get(0); section.getParagraphs().removeAt(0); document.sa veToFile("删除段落后的文档.docx", FileFormat.Docx); document.dispose(); } } ``` ## 3. 进阶应用：为关键词添加边框 有时候文档里的某些关键词需要特别醒目，比如“核心技术”这类词。光改颜色可能还不够，给它加个边框，视觉上直接锁定读者的注意力。 这个库提供了 `findAllString` 方法用来全文搜索，找到匹配的文本后可以给它套上边框样式。 ```ja va import com.spire.doc.Document; import com.spire.doc.FileFormat; import com.spire.doc.documents.BorderStyle; import com.spire.doc.documents.TextSelection; import ja va.awt.*; public class HighlightText { public static void main(String[] args) { Document document = new Document(); document.loadFromFile("报告.docx"); TextSelection[] selections = document.findAllString("核心技术", false, false); for (TextSelection selection : selections) { selection.getAsOneRange().getCharacterFormat().getBorder().setBorderType(BorderStyle.Single); selection.getAsOneRange().getCharacterFormat().getBorder().setColor(Color.RED); selection.getAsOneRange().getCharacterFormat().getBorder().setLineWidth(1); } document.sa veToFile("高亮关键词.docx", FileFormat.Docx); document.dispose(); } } ``` ## 4. 总结 从上面的示例能看出来，Spire.Doc for Ja va 提供的 API 覆盖了 Word 文档操作的主要场景。无论是要在服务端批量生成报表，还是在客户端动态填充数据，这套工具都能让开发者在不安装 Microsoft Office 的前提下，完成常见的编辑任务。有一点需要提醒：操作完成后别忘了调用 `document.dispose()` 释放资源——在高并发环境下，资源泄漏可是个大的麻烦。