Java实现HTML转Word:四种方案深度对比与Apache POI+Jsoup实战
1. 项目缘起为什么要在Java里折腾HTML转Word如果你做过企业级应用开发尤其是那些需要生成报告、合同、单据的系统大概率会遇到一个需求把动态生成的HTML内容完美地输出成一份可以打印、可以存档、可以二次编辑的Word文档。这个需求听起来简单做起来却是个“深坑”。我最早接手这类任务时也天真地以为找个库调个API就完事了结果被各种格式错乱、样式丢失、图片不显示的问题折磨得够呛。为什么不用PDFPDF适合最终分发和打印但交互性差用户无法直接修改。为什么不用纯文本格式太简陋无法满足复杂的排版要求。Word文档.docx格式就成了一个折中的、也是最普遍的需求它既保留了丰富的格式字体、颜色、表格、图片又允许用户进行后续编辑。而HTML作为Web时代最通用的内容描述语言自然就成了我们生成这些动态内容的首选载体。所以“Java实现HTML转Word”这个命题本质上是在解决从Web渲染层到办公文档层的“最后一公里”数据交付问题。市面上相关的库和方案不少比如Apache POI、Flying Saucer配合iText、OpenHTMLtoPDF、Jsoup等等但每个方案都有自己的“脾气”和适用边界。没有一种方案是银弹选择哪种完全取决于你的HTML复杂度和对Word文档保真度的要求。接下来我就结合自己踩过的坑和积累的经验把这几种主流方案的原理、实操和那些“坑爹”的细节给你掰扯清楚。2. 方案选型四种技术路线的深度对比与抉择面对一个HTML字符串在Java里把它变成.docx文件主要有四条技术路径。别急着写代码先搞清楚它们的底层逻辑和能干什么、不能干什么这能帮你省下至少80%的调试时间。2.1 方案一Apache POI XWPF —— 直接编程生成这是最“原始”也最可控的方法。Apache POI是Java操作Office文档的事实标准XWPF组件专门用于处理.docx文件。这个方案不是“转换”HTML而是用Java代码“模仿”HTML的渲染结果去构建Word文档。核心原理你需要手动解析HTML通常用Jsoup然后遍历DOM树。遇到p标签就调用XWPFDocument.createParagraph()创建段落遇到b标签就对当前XWPFRun文本块设置加粗遇到table就创建XWPFTable并递归处理tr和td。图片则需要先解码Base64或读取文件再以字节数组形式插入。优点极致可控文档的每一个细节包括样式、页眉页脚、章节属性都可以精确控制。兼容性最佳生成的是纯正的.docx文件任何版本的Microsoft Word都能完美打开。性能可预期没有复杂的渲染引擎开销处理流程线性。缺点与坑点开发成本极高你需要实现一个简易的HTML渲染引擎。复杂的CSS样式如浮动、定位、Flexbox几乎无法实现。维护噩梦HTML结构或样式一变对应的生成代码可能就要大改。不适用于复杂HTML对于来自富文本编辑器如UEditor、CKEditor的、带有复杂CSS的HTML内容用这种方式还原基本是不可能的任务。实操心得这个方案只适用于HTML结构极其简单、样式固定的场景比如生成一个只包含标题、若干段落和简单表格的纯文本报告。一旦涉及多样化的字体、颜色、边框、背景色代码复杂度会呈指数级上升。我曾经为了还原一个带合并单元格和边框样式的表格写了近200行代码后期微调一个边框颜色都想哭。2.2 方案二Flying Saucer iText —— 先转PDF再转Word这是一个经典的“曲线救国”方案。Flying Saucer现已更名为OpenHTMLtoPDF是一个基于iText的HTML渲染器可以将HTMLCSS渲染成PDF。理论上你可以先得到PDF再用其他库如POI将PDF转为Word。但这听起来就很绕实际上这条路基本走不通。核心原理Flying Saucer/OpenHTMLtoPDF对CSS 2.1的支持非常好能生成高质量的PDF。但PDF和Word是两种完全不同的文档模型。PDF是“只读”的页面描述格式而Word是“可编辑”的流式文档格式。将PDF转回WordOCR识别文字版除外会丢失所有的文档结构文本变成一堆无意义的段落框完全不可编辑。优点HTML/CSS渲染能力强对于需要精确打印排版、生成PDF报告的场景它是顶级选择。缺点与坑点无法用于生成可编辑Word这是此方案对于“HTML转Word”需求的根本性缺陷。最终产物是PDF不是我们想要的.docx。字体处理麻烦需要手动注册字体文件否则中文容易显示为方框。个人建议如果你的最终目标就是PDF请直接使用OpenHTMLtoPDF忘掉Word这回事。如果客户非要Word你可以提供PDF的同时说明Word版本需要额外开发并引导他们接受PDF。2.3 方案三OpenHTMLtoPDF 的“表亲”—— 直接渲染到文档这里有个容易混淆的点。我们说的“转换”其实有两种理解一是格式转换Format Conversion二是渲染输出Rendering。上述方案一和二是两种思路。而有些库它本身的目标是渲染但输出格式可以是多种。不过在Java生态中目前没有成熟稳定的、能直接将HTML渲染成.docx文件流的开源库。像html2docx这样的项目要么已停止维护要么功能非常有限。2.4 方案四外部命令调用 —— 借用浏览器的力量这是目前对于复杂HTML转换保真度最高的实用方案。核心思想是利用一个无头浏览器如Chrome/Chromium来完美渲染HTML然后利用浏览器或相关工具将渲染后的页面“打印”或“导出”为Word文档。具体实现有两种主流方式使用docx4j与docx4j-ImportXHTMLdocx4j是另一个强大的Java操作OpenXMLdocx的库。它的ImportXHTML模块尝试将XHTML格式良好的HTML导入到docx文档对象中。其底层原理并非完美渲染而是尝试将HTML标签映射为Word的OpenXML结构。它对简单HTML支持尚可但对现代CSS支持有限。使用Puppeteer/Playwright控制Chrome这是当前最推荐的做法。你可以在Java中通过进程调用或使用Java客户端如playwright-java来启动一个无头Chrome浏览器加载你的HTML然后使用Chrome DevTools Protocol的Page.printToPDF命令虽然叫PDF但可以控制或更直接地利用浏览器模拟“另存为”功能。但更常见的做法是先转为PDF再利用POI或其他库将PDF转为可编辑的Word不这又回到了方案二的死胡同。实际上更成熟的链路是HTML - (通过无头浏览器) - 高保真PDF - (通过付费或高级OCR转换服务) - 可编辑Word。或者如果你的用户接受“图片式”的Word你可以将HTML渲染成一张长图插入到Word的一个段落中但这完全不可编辑。那么到底有没有靠谱的一站式方案有但通常不是纯免费开源的。例如商业库Aspose.Words for Java提供了强大的DocumentBuilder.insertHtml()方法能够将HTML直接插入到Word文档中并保持较高的格式保真度。它是收费的但功能强大、稳定。对于企业级项目如果预算允许这往往是性价比最高的选择因为它节省了大量的开发和调试成本。3. 实战聚焦基于Apache POI与Jsoup的轻量级转换器实现鉴于大多数情况我们遇到的是中等复杂度的HTML来自富文本编辑器的内容这里我深度讲解一个结合了Apache POI和Jsoup的实用方案。这个方案不追求100%还原CSS而是实现一个“足够好”的转换涵盖标题、段落、加粗斜体、下划线、字体颜色、简单表格和图片。3.1 环境准备与核心依赖首先在你的pom.xml中引入必要的依赖。我们使用较新且稳定的版本。dependencies !-- Apache POI for Word .docx -- dependency groupIdorg.apache.poi/groupId artifactIdpoi-ooxml/artifactId version5.2.3/version /dependency !-- Jsoup for HTML parsing -- dependency groupIdorg.jsoup/groupId artifactIdjsoup/artifactId version1.17.2/version /dependency !-- 用于Base64图片解码等 -- dependency groupIdcommons-io/groupId artifactIdcommons-io/artifactId version2.13.0/version /dependency /dependencies3.2 核心转换器设计思路我们不会写一个万能解析器而是针对常见HTML标签进行映射。核心类是HtmlToWordConverter它主要做两件事解析使用Jsoup将输入的HTML字符串清理并解析成DOM树。Jsoup能很好地处理不规范的HTML。映射与创建遍历DOM树根据节点类型标签名、样式调用POI的API在XWPFDocument对象中创建对应的元素。为什么选择遍历而不是XSLT因为我们需要在遍历过程中维护上下文状态比如当前段落XWPFParagraph、当前文本运行XWPFRun、当前的列表层级等。用XSLT转换到OpenXML极其复杂而过程式代码虽然冗长但更直观、易于调试和定制。3.3 关键代码模块拆解3.3.1 文档初始化与根元素处理import org.apache.poi.xwpf.usermodel.*; import org.jsoup.Jsoup; import org.jsoup.nodes.Document; import org.jsoup.nodes.Element; import org.jsoup.nodes.Node; import org.apache.poi.util.Units; import java.io.*; import java.util.HashMap; import java.util.Map; import java.util.regex.Matcher; import java.util.regex.Pattern; public class HtmlToWordConverter { private XWPFDocument document; private XWPFParagraph currentParagraph; private XWPFRun currentRun; // 用于缓存样式避免为每个Run重复创建 private MapString, XWPFRun styleRunCache new HashMap(); // 处理列表的嵌套层级 private int listLevel -1; public HtmlToWordConverter() { this.document new XWPFDocument(); } public void convertHtml(String htmlContent) { // 使用Jsoup清理和解析HTML确保有完整的body标签 String wrappedHtml htmlbody htmlContent /body/html; Document jsoupDoc Jsoup.parse(wrappedHtml, UTF-8); Element body jsoupDoc.body(); // 遍历body的所有直接子节点 for (Node node : body.childNodes()) { processNode(node); } } private void processNode(Node node) { if (node instanceof org.jsoup.nodes.TextNode) { // 处理文本节点 String text ((org.jsoup.nodes.TextNode) node).getWholeText(); if (!text.trim().isEmpty()) { ensureParagraphExists(); if (currentRun null) { currentRun currentParagraph.createRun(); } currentRun.setText(text, 0); // 0表示从第一个字符开始替换 } } else if (node instanceof Element) { // 处理元素节点 processElement((Element) node); } } }这里的关键是ensureParagraphExists()方法它确保在处理文本或某些块级元素前当前有一个有效的段落对象。因为Word文档的基本单位是段落Paragraph。3.3.2 块级元素与行内元素的处理策略块级元素如p,div,h1-h6通常需要创建新的段落。而行内元素如b,i,span则影响当前文本运行的样式。private void processElement(Element element) { String tagName element.tagName().toLowerCase(); switch (tagName) { case p: case div: // 创建新段落并继承处理子节点 createNewParagraph(); for (Node child : element.childNodes()) { processNode(child); } // 一个段落结束重置currentRun以便下一个元素创建新的Run currentRun null; break; case h1: case h2: case h3: case h4: case h5: case h6: createNewParagraph(); currentRun currentParagraph.createRun(); currentRun.setText(element.text()); currentRun.setBold(true); int fontSize 28 - (Integer.parseInt(tagName.substring(1)) - 1) * 4; // 简单计算字体大小 currentRun.setFontSize(fontSize); currentParagraph.setStyle(Heading tagName.substring(1)); currentRun null; // 标题文本单独在一个Run后续内容新起段落 break; case b: case strong: applyStyleToChildRuns(element, run - run.setBold(true)); break; case i: case em: applyStyleToChildRuns(element, run - run.setItalic(true)); break; case u: applyStyleToChildRuns(element, run - run.setUnderline(UnderlinePatterns.SINGLE)); break; case br: ensureParagraphExists(); if (currentRun ! null) { currentRun.addBreak(); // 在Run内换行 } else { currentParagraph.createRun().addBreak(); } break; // ... 处理其他标签如table, img, ul, ol等 default: // 对于未明确处理的标签默认递归处理其子节点保证内容不丢失 for (Node child : element.childNodes()) { processNode(child); } break; } } private void applyStyleToChildRuns(Element element, java.util.function.ConsumerXWPFRun styleApplier) { // 保存当前Run的引用 XWPFRun originalRun currentRun; // 临时将currentRun置为null迫使在处理子元素时创建新的Run来应用样式 currentRun null; for (Node child : element.childNodes()) { processNode(child); // 每次processNode后如果创建了Run则对其应用样式 if (currentRun ! null currentRun ! originalRun) { styleApplier.accept(currentRun); } } // 恢复原来的Run如果有但通常行内样式结束后后续内容应该新起Run currentRun null; }applyStyleToChildRuns这个方法是个技巧点。因为b内容/b可能包含文本和其他行内元素我们需要确保这个b标签内的所有文本都加粗。我们的策略是在处理这个元素时临时“中断”当前的Run让它的子节点去创建新的Run然后立即对这些新Run应用样式。3.3.3 图片与表格的处理细节图片处理HTML中的图片可能是外链URL也可能是Base64内嵌数据常见于富文本编辑器。我们需要区分处理。case img: ensureParagraphExists(); String src element.attr(src); if (src.startsWith(data:image)) { // 处理Base64图片 Pattern pattern Pattern.compile(^data:image/(\\w);base64,); Matcher matcher pattern.matcher(src); if (matcher.find()) { String base64Data src.substring(matcher.end()); byte[] imageBytes java.util.Base64.getDecoder().decode(base64Data); try (ByteArrayInputStream bis new ByteArrayInputStream(imageBytes)) { // 获取图片格式 String format matcher.group(1).toLowerCase(); int pictureType getPictureType(format); // 插入图片到当前段落 currentRun currentParagraph.createRun(); currentRun.addPicture(bis, pictureType, image, Units.toEMU(200), Units.toEMU(150)); // 设置宽高 currentRun null; } catch (Exception e) { e.printStackTrace(); // 出错时插入一个替代文本 currentRun currentParagraph.createRun(); currentRun.setText([图片加载失败]); } } } else { // 处理网络图片或本地图片需要额外下载或读取逻辑此处略 currentRun currentParagraph.createRun(); currentRun.setText([图片: src ]); } break; private int getPictureType(String format) { switch (format) { case png: return XWPFDocument.PICTURE_TYPE_PNG; case jpeg: case jpg: return XWPFDocument.PICTURE_TYPE_JPEG; case gif: return XWPFDocument.PICTURE_TYPE_GIF; case bmp: return XWPFDocument.PICTURE_TYPE_BMP; default: return XWPFDocument.PICTURE_TYPE_PNG; } }表格处理HTML表格(table)到Word表格(XWPFTable)的映射相对直接但需要注意单元格合并(colspan,rowspan)和样式。case table: // 获取表格行 Elements rows element.select(tr); if (rows.isEmpty()) break; // 计算列数取第一行的单元格数考虑colspan int numCols 0; Elements firstRowCells rows.first().select(td, th); for (Element cell : firstRowCells) { int colspan Integer.parseInt(cell.attr(colspan).isEmpty() ? 1 : cell.attr(colspan)); numCols colspan; } // 创建Word表格 XWPFTable table document.createTable(rows.size(), numCols); // 遍历行和单元格填充内容 for (int i 0; i rows.size(); i) { Element rowElem rows.get(i); XWPFTableRow tableRow table.getRow(i); Elements cells rowElem.select(td, th); int colIndex 0; for (Element cellElem : cells) { XWPFTableCell tableCell tableRow.getCell(colIndex); // 处理单元格内容递归 HtmlToWordConverter cellConverter new HtmlToWordConverter(); cellConverter.document this.document; // 复用主文档 cellConverter.currentParagraph tableCell.getParagraphs().get(0); cellConverter.currentRun null; for (Node child : cellElem.childNodes()) { cellConverter.processNode(child); } // 处理colspan/rowspan (POI处理合并较复杂需要调用mergeCells方法此处简化) int colspan Integer.parseInt(cellElem.attr(colspan).isEmpty() ? 1 : cellElem.attr(colspan)); if (colspan 1) { // 实际项目中需要更复杂的合并逻辑 // table.mergeCellsHorizontally(rowIndex, fromCol, toCol); } colIndex colspan; } } // 表格后通常新起一个段落 createNewParagraph(); break;表格处理是难点尤其是合并单元格。POI提供了XWPFTable.mergeCells()方法但你需要精确计算合并的起始和结束行列索引。上述代码仅提供了基础框架完整的合并逻辑需要更复杂的DOM遍历和状态记录。3.4 样式映射与字体处理简单的样式加粗、斜体可以通过XWPFRun的方法设置。但更复杂的CSS样式如color,font-family,background-color,text-align处理起来就很棘手。字体颜色示例// 在applyStyleToChildRuns或专门的样式处理函数中 String style element.attr(style); if (style.contains(color)) { // 简单提取颜色值如 color: #FF0000; 或 color: red; // 实际需要更健壮的CSS解析 java.util.regex.Pattern colorPattern java.util.regex.Pattern.compile(color:\\s*(#[0-9a-fA-F]{6}|#[0-9a-fA-F]{3}|\\w)); java.util.regex.Matcher m colorPattern.matcher(style); if (m.find()) { String colorStr m.group(1); currentRun.setColor(colorStr); // POI的setColor接受 hex string without # } }关于中文字体默认生成的Word文档可能使用英文字体导致中文显示异常。你可以在创建XWPFRun后统一设置中文字体。private void ensureParagraphExists() { if (currentParagraph null) { currentParagraph document.createParagraph(); // 可以在这里设置段落默认样式 } if (currentRun null) { currentRun currentParagraph.createRun(); // 设置默认字体 currentRun.setFontFamily(宋体); currentRun.setFontSize(12); } }4. 避坑指南那些让你熬夜调试的典型问题即使按照上面的框架实现了在实际运行中你一定会遇到下面这些问题。我把它们和解决方案列出来希望能帮你节省时间。4.1 图片Base64解码与格式识别错误问题从富文本编辑器如CKEditor粘贴过来的图片其src可能是data:image/png;base64,iVBORw0...格式。正则表达式匹配不准确或者Base64字符串包含换行符导致解码失败。排查与解决增强正则使用更宽容的正则如Pattern.compile(^data:image/([\\w]);base64,([\\s\\S]*))同时捕获格式和内容。清理Base64数据解码前移除所有空白字符空格、换行、制表符。String base64Data src.substring(matcher.start(2)); base64Data base64Data.replaceAll(\\s, ); // 关键步骤 byte[] imageBytes java.util.Base64.getDecoder().decode(base64Data);异常处理与降级一定要用try-catch包裹解码和插入过程一旦失败插入一个友好的错误提示文本如[图片]而不是让整个转换崩溃。4.2 Word文档打开缓慢或“容易卡”问题生成的.docx文件在用户电脑上用Word打开时加载特别慢甚至卡死。这在处理了多张大图或超长表格后尤其常见。根因分析图片未压缩直接插入高分辨率、大尺寸的Base64图片会导致Word文件体积暴增。Word在渲染时需要解压和处理这些大图。文档结构复杂虽然POI生成的XML是规范的但如果你创建了成千上万个极其细碎的XWPFRun对象比如每个字都带不同样式会导致文档的XML结构异常复杂影响解析性能。样式冗余为每个XWPFRun重复设置相同的字体、大小等样式没有利用好Word的样式继承机制。优化策略图片压缩与缩放在插入图片前使用ImageIO或Thumbnails等库将图片压缩到适合文档显示的尺寸如宽度不超过800像素。// 伪代码示例 BufferedImage originalImage ImageIO.read(new ByteArrayInputStream(imageBytes)); int maxWidth 800; if (originalImage.getWidth() maxWidth) { double ratio (double) maxWidth / originalImage.getWidth(); int newHeight (int) (originalImage.getHeight() * ratio); BufferedImage resizedImage new BufferedImage(maxWidth, newHeight, originalImage.getType()); // ... 使用Graphics2D进行缩放 ... // 将resizedImage转回byte[] }合并文本运行在遍历DOM树时将连续的、样式相同的文本节点合并到一个XWPFRun中而不是为每个文本节点都创建新的Run。使用段落样式对于大量具有相同样式的段落如正文不要为每个段落单独设置字体大小而是定义一个XWPFStyle并应用到这些段落上。4.3 样式丢失与布局错乱问题HTML里的div嵌套、float、position、flex布局在Word里完全失效内容堆在一起。本质原因Word的布局模型和HTML/CSS的盒子模型根本不同。Word是流式文档主要依靠段落、表格、文本框来定位。复杂的CSS布局无法直接映射。应对方案放弃复杂布局与需求方沟通明确告知HTML到Word的转换有局限性建议使用更简单的、面向打印的HTML结构。避免使用float,position: absolute,flex,grid等布局。用表格模拟布局对于需要多栏、对齐的简单布局可以用无边框的HTML表格table来模拟。Word对表格的支持相对较好。使用文本框谨慎POI可以创建文本框XWPFTextBox但跨页、排版非常麻烦不推荐大量使用。4.4 列表ul/ol编号混乱问题多层嵌套的列表在Word中编号不连续或者全部变成同一个级别。解决方案在转换器中维护一个listLevel栈或计数器。遇到ul或ol时listLevel并在创建段落时应用对应的Word列表样式。POI中列表样式XWPFNumbering的设置非常繁琐需要先定义NumberingDefinition然后为段落设置setNumID。这是一个独立的话题如果列表功能重要建议专门研究POI的编号机制或者考虑简化需求将列表转换为普通段落加前缀符号如•,1.。5. 进阶考量性能、扩展性与生产环境部署当一个简单的工具类需要部署到生产环境服务大量并发请求时以下几个问题必须考虑。5.1 内存管理与大文件处理POI在处理大型文档时如果将所有内容都放在内存中的XWPFDocument对象里极易引发OutOfMemoryError。优化方向使用SXSSF模式抱歉SXSSF只针对Excel.xlsx。POI对于Word没有类似的流式写入API。这意味着处理超大Word文档本身就是POI的软肋。分块处理如果业务允许考虑将大的HTML内容拆分成多个小的Word文档。增加JVM堆内存这是最直接但最不优雅的方式。通过-Xmx参数调整。探索替代方案对于超大规模文档生成可以考虑换用Aspose.Words商业或评估docx4j的性能。或者回归本源思考是否真的需要生成一个完整的、巨大的Word文件能否分页生成多个文件或改用PDF5.2 异步处理与任务队列HTML转Word可能是一个耗时操作尤其是在处理复杂内容或大量图片时。绝不能在Web请求的同步线程中直接处理否则会很快拖垮服务器。标准做法请求异步化接口接收到转换请求后立即返回一个taskId或jobId。提交任务队列将转换任务包含HTML内容、参数等提交到消息队列如RabbitMQ、Kafka或内存队列如ThreadPoolExecutor。后台处理由独立的消费者线程从队列中取出任务执行耗时的转换逻辑。结果通知转换完成后将生成的Word文件上传到OSS或文件服务器并将可下载的URL通过WebSocket、回调接口或让客户端轮询taskId状态的方式返回给用户。5.3 样式模板与定制化很多时候生成的Word文档需要符合公司统一的模板规范比如固定的页眉页脚、特定的标题样式、公司Logo等。最佳实践准备模板文件先用Microsoft Word手动创建一个完美的.docx模板文件设置好所有样式“样式”窗格中的标题1、标题2、正文等、页眉页脚、封面页。使用POI读取模板在代码中不要new XWPFDocument()而是通过FileInputStream读取这个模板文件。InputStream templateStream new FileInputStream(template.docx); XWPFDocument document new XWPFDocument(templateStream); templateStream.close();应用样式在创建段落时使用paragraph.setStyle(StyleName)来应用模板中定义好的样式而不是硬编码字体和大小。这样生成的文档不仅风格统一而且用户可以在Word中通过“修改样式”一键更新整个文档的格式。6. 总结与选型决策树走了这么多弯路看了这么多方案最后该如何选择我画了一个简单的决策树你可以根据你的实际需求对号入座需求复杂度你的HTML是否来自富文本编辑器包含复杂的CSS和布局否简单文本图片表格- 跳到第2步。是- 认真考虑商业库如Aspose.Words或无头浏览器方案。这是保真度和开发成本之间的权衡。如果预算有限且保真度要求不是极高可以尝试用方案四POIJsoup并严格约束前端输入的HTML样式只允许使用一个受限的子集比如通过白名单过滤标签和CSS属性。文档保真度要求用户是否要求Word文档必须和网页预览“一模一样”否内容正确、格式大体一致即可-方案四POIJsoup是性价比最高的选择。你需要投入开发时间但拥有完全的控制权且运行时无额外依赖。是- 回到第1步的“是”分支。项目预算与时间是否有购买商业库的预算项目工期是否紧张有预算/工期紧-优先选择商业库Aspose.Words。它的insertHtml方法成熟稳定能处理绝大多数情况API简单能为你节省数周甚至数月的开发调试时间。这笔钱对于企业项目来说往往是值得的。无预算/工期充裕- 选择方案四POIJsoup但要做好持续迭代和维护的心理准备。这是一个“轮子”你需要自己打磨。输出格式是否必须是.docx否PDF也可以-直接使用OpenHTMLtoPDF。这是生成PDF最专业、最靠谱的Java方案别再绕道Word了。最后我个人在经历了多个此类项目后形成的习惯是对于内部管理后台、对格式要求不严的报告生成用自研的POIJsoup转换器并严格限定前端样式。对于对外的、正式的、格式要求严格的合同、报告等文档向公司申请预算购买Aspose.Words。毕竟程序员的时间也是成本而稳定可靠的输出对于商业项目而言至关重要。在动手编码前花时间和产品经理、业务方明确“足够好”的标准往往比选择什么技术方案更重要。

相关新闻

Python网页文档爬取实战:从Requests到DrissionPage的完整解决方案

Python网页文档爬取实战:从Requests到DrissionPage的完整解决方案

1. 项目概述:从网页中高效捕获结构化文档在数据驱动的时代,我们经常遇到这样的场景:一份至关重要的行业报告、一篇学术论文的预印本、一份产品技术规格书,它们静静地躺在某个网页上,但下载链接却是一个PDF或Word文档。…

2026/9/25 15:58:07 阅读更多 →
Spring Boot 应用对接 Prometheus 监控指南

Spring Boot 应用对接 Prometheus 监控指南

Spring Boot 应用对接 Prometheus 监控指南 本文档介绍如何将 Spring Boot 应用接入 Prometheus 监控体系,分无认证和 Basic Auth 认证两种情况说明。一、技术栈组件用途Micrometer指标采集门面Spring Boot Actuator暴露监控端点Prometheus指标采集 时序数据库Graf…

2026/9/26 7:54:05 阅读更多 →
hubuild中的uniapp项目运行在Android Studio平板模拟器中

hubuild中的uniapp项目运行在Android Studio平板模拟器中

1.下载Android Studio2.打开设备管理器打开后如图打开后这个列表是空的,我的是已经添加了,点击左上角加号,左侧选择Tablet,就是平板的意思,右侧随便选一个,第三个是我自己自定义添加的,是点击左…

2026/9/23 20:55:40 阅读更多 →

最新新闻

数智码力:普通人学Python,不必追求独立开发项目,会“改造脚本”就够用

数智码力:普通人学Python,不必追求独立开发项目,会“改造脚本”就够用

很多新手自学Python,都被错误的学习标准误导:认为学Python的终极目标,是从零独立开发完整项目,写出专属代码。达不到这个标准,就觉得自己没学好、学无用功。其实对于99%的普通人、职场人、学生而言,完全不需…

2026/9/26 8:50:36 阅读更多 →
llama.cpp KV缓存量化实战:降低71%显存的关键技术

llama.cpp KV缓存量化实战:降低71%显存的关键技术

1. 项目概述:为什么“KV量化”成了llama.cpp长上下文落地的生死线最近两周,我在给一个嵌入式边缘设备部署7B级别大模型时,连续踩了三次显存墙——不是GPU爆显存,而是Android端用llama.cpp跑4K上下文直接OOM。直到我把-kv参数从默认…

2026/9/26 8:50:36 阅读更多 →
WorkBuddy Enterprise企业级Agent平台:从超级个体到超级团队的落地实践

WorkBuddy Enterprise企业级Agent平台:从超级个体到超级团队的落地实践

1. 从「超级个体」到「超级团队」:这个平台到底在解决什么问题 第一次看到「WorkBuddy Enterprise」这个名字,我脑子里蹦出来的第一个念头是:腾讯云终于把 CodeBuddy 那套东西往企业级方向推了。如果你最近半年一直在关注 AI Agent 这个赛道&…

2026/9/26 8:50:36 阅读更多 →
达芬奇稳定工作流配置指南:硬件适配、GPU加速与许可证管理

达芬奇稳定工作流配置指南:硬件适配、GPU加速与许可证管理

1. 这不是“破解教程”,而是一套可长期稳定使用的达芬奇专业工作流配置方案 达芬奇(DaVinci Resolve)——这个名字在影视后期圈里,几乎等同于“调色天花板”和“剪辑全能王”。但凡做过3分钟以上成片的人,都绕不开它&…

2026/9/26 8:50:35 阅读更多 →
燃料电池复合能源系统三十六计:从架构选型到运维实战

燃料电池复合能源系统三十六计:从架构选型到运维实战

干过几年燃料电池复合能源系统的人都有个共同感受:整个系统里最让人头疼的不是电堆本身,而是电堆周围那一圈“配角”——锂电池充放电策略对不对、DC/DC选型留了多少裕量、冬天冷却液能不能拉起来、故障码出现之后保护动作顺序合不合理。所谓复合能源&am…

2026/9/26 8:50:35 阅读更多 →
MySQL 5.7.22 生产部署指南:兼容性、安全初始化与 systemd 管理

MySQL 5.7.22 生产部署指南:兼容性、安全初始化与 systemd 管理

简介:本资源为MySQL 5.7.22官方Windows 32位安装包(mysql-5.7.22-win32),面向数据库初学者、运维人员及中小型项目开发者,用于快速部署稳定可靠的开源关系型数据库环境。压缩包共365个文件,含83个动态链接库…

2026/9/26 8:49:35 阅读更多 →

日新闻

数据库课后习题答案别硬背:当测试用例集刷,效率翻倍

数据库课后习题答案别硬背:当测试用例集刷,效率翻倍

简介:万常选版《数据库原理与设计》课后习题答案资源,覆盖第2至6章及第9章,适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件,含3个doc参考答案、2个sql示例脚本、…

2026/9/26 0:00:25 阅读更多 →
学校官网模拟全流程实践:从页面布局到后端接口与部署

学校官网模拟全流程实践:从页面布局到后端接口与部署

如果你正在找一门 Web 大作业的题目,或者刚开始接触 Web 前端开发想做点能拿来展示的东西,“学校官网模拟”几乎是最稳的选择。题目看着简单,但要把导航、新闻列表、轮播 Banner、二级页面、后台数据都串起来,其实已经把前端布局、…

2026/9/26 0:00:25 阅读更多 →
超级玛丽游戏源码C++:从零搭建横版跳跃游戏工程

超级玛丽游戏源码C++:从零搭建横版跳跃游戏工程

简介:这是一份面向游戏开发初学者与C进阶学习者的超级玛丽(超级马里奥)游戏源码,基于C面向对象编程实现,适合想通过经典项目理解游戏主循环、角色类设计、地图关卡加载与物理碰撞检测的读者参考。压缩包共49个文件&…

2026/9/26 0:00:25 阅读更多 →

周新闻

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

直接铺开项目本身吧。这几个月我一直在折腾一件事:用Flutter给OpenHarmony做一款游戏集合类的App,说白了就是把若干小游戏塞进一个壳里,用统一入口分发。这个方向本身不算新鲜,真正让我花了不少心思的,是首页那堆游戏卡…

2026/9/25 19:27:14 阅读更多 →
Word表格编号全攻略:从列表编号到题注交叉引用

Word表格编号全攻略:从列表编号到题注交叉引用

写Word文档,最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事:今天在表后面多加了两个空白行,明天给客户交稿前发现整个章节的编号全部错位,光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技…

2026/9/25 11:15:26 阅读更多 →
从第一个站到第二个站:独立开发者的静态网站选型与落地实践

从第一个站到第二个站:独立开发者的静态网站选型与落地实践

1. 项目概述1.1 核心需求解析做独立开发者这几年,说实话,第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年,流量惨淡、功能臃肿、代码自己都懒得看第二遍之后,我才慢慢琢磨明白一个道理:第一个网站是练手&…

2026/9/25 20:29:09 阅读更多 →

月新闻

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能分类:[AI/大模型]细分主题:AI 增强型 CI/CD 流水线自动化与 GitOps 实践:Agent 工作流、工具调用与任务拆解:从原型到生产的验收清单很多团队在尝试用大…

2026/9/25 20:29:43 阅读更多 →
容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场分类:[工程技术]细分主题:Kubernetes 生产环境运维与排障实战:可复制的项目复盘模板与决策记录大部分团队的事故复盘报告,最后都变成了躺在 Confluence 或钉…

2026/9/25 20:29:31 阅读更多 →
容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步分类:[工程技术]细分主题:Docker 容器化技术与镜像安全管理:核心链路的逐步实现与关键代码取舍面对一个积累了五六年历史包袱的单体架构应用(包含 Web 接口、后台…

2026/9/25 19:27:26 阅读更多 →