简介面向Java Web开发者的Lodop打印解决方案资源包集打印控件安装程序、JavaScript封装库与大量可运行的HTML示例于一体适用于需要在Web系统中实现单据、标签、条形码、二维码及图文混排等复杂打印功能的应用。压缩包共58个文件以52个HTML示例页面为主体配合1份CSS样式表、2份JS脚本以及Windows 32/64位安装程序可满足不同操作系统环境下的部署需求。示例模板覆盖表格打印、图片输出、自定义页面布局等典型业务场景从基础样例到综合示例逐步展示控件初始化的完整流程、样式控制方法以及实际项目中的调用方式其中的LodopFuncs.js对常用打印逻辑做了封装开发者可直接嵌入项目使用CSS文件则负责统一打印外观。安装程序区别32位与64位系统内置服务组件安装后即可被Java后端调用。资源包整体仅9.42MB轻量易用已有942人学习下载。对于希望快速集成打印能力的初中级开发者从环境搭建、样例对照到二次改造都有清晰参照可显著降低开发与调试成本。1. Lodop 打印模板和安装包Java Web 项目里最顺手的打印方案Lodop 打印模板和安装包在 Java Web 项目里一般是连着出现的一对东西。浏览器里做打印最烦的不是打不出来而是 CtrlP 一按套打单的位置全乱换个浏览器布局又崩。Lodop 的做法是客户端装一个本地打印控件网页用 JS 发指令由控件负责排版和驱动打印机。对做 OA、订单后台、进销存的开发者来说这是上手最快的一条路。这篇会从安装部署讲到模板坐标、字体、条码、批量打印顺手把能踩的坑先标出来照着资源包里的模板改数据就能落地。2. 安装与部署客户端装控件、Java 工程放 JS三步跑通最小打印2.1 为什么非得在客户端装一个控件浏览器出于安全限制网页本身碰不到打印机的驱动和系统打印接口。早些年 IE 还能靠 ActiveX 特权调动本地资源现在主流浏览器都收紧权限所以 Lodop 的做法是把打印引擎做成一个随安装包装到 Windows 客户端的本地控件网页里的 JS 只负责把排版指令发过去。服务端不需要装任何东西只需要把配套的 JS 文件托管在 Web 工程里。理解这一点安装包才不会放错位置。我见过不少第一次接触的人把安装包扔到服务器上双击一遍然后问为什么客户端还是打不了——谁要打印谁就要装。这个区分是后面所有排错的前提。另一个容易被忽略的点是安装包通常拆成 32 位和 64 位两个程序64 位系统配 64 位浏览器装 64 位包但很多老系统的 IE 是 32 位进程跑在 64 位系统上那就得装 32 位包。拿不准时两个都装多数项目里这样最省事。2.2 部署三步装控件、放 JS、写检查页第一步到客户端装控件。资源包里带上的是给 Windows 用的安装包双击按提示装完最好把浏览器全部关掉再重开让控件重新加载。IE 下它会变成 ActiveX 直接可用非 IE 浏览器近年对第三方扩展卡得严装完插件之后还要到扩展管理页确认它已启用并把系统的访问地址加入允许列表否则 getLODOP() 一直返回 undefined。第二步把 JS 放进 Java 工程。Lodop 配套的 LodopFuncs.js 本质是一个探测脚本内部负责三件事检测本机是否已装控件、拿到控件对象引用、在缺失时给出安装提示。把它放到类似 /static/lodop/ 的目录JSP 里这样引入script src${pageContext.request.contextPath}/static/lodop/LodopFuncs.js/script script var LODOP getLODOP(); if (!LODOP) { alert(未检测到本地打印控件请先运行安装包再重启浏览器); } /script这里用 JSP 的 EL 表达式拼出工程根路径避免部署到二级目录时路径写死。getLODOP() 的返回值是后续所有打印操作的对象它取不到后面的 ADD_PRINT_* 和 PREVIEW 都不会有反应。注意不同版本的 LodopFuncs.js 暴露的函数名大小写可能有差别有的写 getLODOP有的写 getLodop以你从资源包里引入的那个为准别从旧项目随手复制一个。注意切换 32 位和 64 位安装包之后一定要重启浏览器再测控件加载是一次性的。第三步放一个最小打印页验证。第一次跑通打印一张带方框的测试页先把“能不能调出预览”这个风险消掉再谈模板var LODOP getLODOP(); LODOP.PRINT_INIT(测试任务); LODOP.SET_PRINT_PAGESIZE(1, 2100, 2970, A4); LODOP.ADD_PRINT_TEXT(80, 80, 1000, 100, 这是一行测试文本); LODOP.PREVIEW();这段代码就是 Lodop 的最小组装逻辑PRINT_INIT 创建新打印任务SET_PRINT_PAGESIZE 指定纸张为竖向 A4ADD_PRINT_TEXT 放一行文本PREVIEW 弹预览框。SET_PRINT_PAGESIZE 的 2100、2970 是以 0.1mm 为单位的 A4 宽高后面所有 ADD_ 坐标都是这个单位。2.3 先搞懂 0.1mm 这个尺寸单位打印模板里填的左、上、宽、高不是像素。Lodop 以 0.1mm 为单位这也是很多模板“看起来差一点”的根源A4 是 2100×2970一个 10mm 高的表头行高度值就是 100。习惯用像素排版的人很容易写出 300 这种数字结果印出来只有 3cm 而不是想象的 30px。写模板前把常见纸张换算表放旁边A5 是 1480×2100B5 是 1760×2500宽高都是毫米数乘 10。单位统一之后不同模板之间才能互相换算坐标。有人在模板里把 100 当成 1mm 用换一台设备就整个乱掉基本就是单位换算出了问题。3. 打印模板怎么拼从 Java 后端数据到一张可出纸的票据3.1 模板的三段式结构初始化、塞内容、发送所有 Lodop 模板都是同一套骨架。第一段创建任务PRINT_INIT 给任务起名任务名不要留空批量打印时会按名排队第二段按布局塞入文本、表格、条码和图片顺序就是纸张上的覆盖顺序后加的会盖住先加的第三段决定去向PREVIEW 预览PRINT 直接送打印机PRINT_SETUP 调出打印设置对话框。调试阶段永远先用 PREVIEW批量任务里才换成 PRINT。这个三段式别打乱尤其不要在 PRINT_INIT 之前调用任何 ADD_否则控件会抛异常或者干脆不渲染。资源包里的模板都是按这个骨架组织的拿到手先找 PRINT_INIT再看 ADD_ 指令最后看收尾用的是 PREVIEW 还是 PRINT。3.2 常用指令速查与模板实例一张单据最常用的指令就这几个指令作用坐标单位PRINT_INIT创建打印任务忽略SET_PRINT_PAGESIZE指定纸张朝向和尺寸0.1mmADD_PRINT_TEXT打印普通文本0.1mmADD_PRINT_TABLE打印 HTML 表格0.1mmADD_PRINT_HTM打印整段 HTML0.1mmADD_PRINT_BARCODE打印条码/二维码0.1mmPREVIEW弹出预览框忽略每行 ADD_ 的前四个数字代表位置和尺寸但不同指令的参数顺序不完全一致文本和条码两组方法各有各的坐标约定互相之间并不统一。资源包里的模板已经把每一行调好了你新增内容时复制同类指令那一行来改别从文本行抄到条码行改完一张预览一张。一个典型的订单票据模板长这样function printOrder(order) { var LODOP getLODOP(); LODOP.PRINT_INIT(订单_ order.no); LODOP.SET_PRINT_PAGESIZE(1, 2100, 2970, A4); LODOP.ADD_PRINT_TEXT(120, 80, 800, 40, 订单号 order.no); LODOP.ADD_PRINT_TEXT(170, 80, 1200, 40, 客户 order.customer); var tableHtml table border1 styleborder-collapse:collapse;width:100% trtd品名/tdtd数量/tdtd单价/td/tr; order.items.forEach(function (it) { tableHtml trtd it.name /tdtd it.qty /tdtd it.price /td/tr; }); tableHtml /table; LODOP.ADD_PRINT_TABLE(230, 80, 1800, 800, tableHtml); LODOP.ADD_PRINT_BARCODE(900, 80, 160, 400, Code128, order.no); LODOP.PREVIEW(); }逻辑说明这个函数接收 Java 端组装好的 order 对象先初始化任务再依次放两行文本、一张明细表、一个 Code128 条码最后交给用户预览。ADD_PRINT_TABLE 的第五个参数是拼出来的 HTML 字符串表格宽度用百分比换打印机驱动时不容易撑破纸张。条码的第六个参数传订单号内容超过一定长度时要改用 Code128而不是位数固定的 EAN 类型。参数说明文本、表格、条码的起始位置都落在 80 这个边界值上适合 210mm 宽的纸纵向从 120 开始每行递增 50 左右保证不重叠。真正微调时别按像素思维硬记哪个数字是横坐标直接对照预览图调整改完看效果。3.3 Java 后端怎么把数据喂进模板Lodop 模板本质是 JSJava 后端把数据送到 JS 手里是整套流程的关键。比较土但稳定的做法JSP 用 c:forEach 输出隐藏 input 节点前端再用 dataset 读取。不用 AJAX也不用在 JSP 里拼大段 Script结构直观出了问题也好定位。c:forEach items${orders} varitem input typehidden classorder-row >document.querySelectorAll(.order-row).forEach(function (node) { var order { no: node.dataset.no, name: node.dataset.name, qty: node.dataset.qty }; printOrder(order); });这段把 Java 渲染到页面的订单列表逐条转成对象再调 printOrder。注意 dataset 读出来全是字符串需要参与计算或排序的字段要先转成数字否则数量“02”这种字符串会原样印上去。3.4 内容超过一页时怎么处理单据明细多了一段表格放不下常见做法是按行数分页明细每 20 行切一组每组生成一个带 page-break-after 的 HTML 块用 ADD_PRINT_HTM 输出到新页面。还有一种更粗暴但稳定的做法是循环里每次重新 PRINT_INIT把超过一页的明细拆成多个打印任务每页一个任务。ERP 里的一单多联经常这么干。拆页时注意页码变量放在模板顶部区域打印客户拿到手才分得清第一联和第二联。4. 避坑与排查坐标偏移、中文乱码、水印和浏览器兼容以下几条是从实际项目里踩出来的每一条都先说现象再说原因和解决。4.1 中文乱码预览正常出纸变方块现象预览框里中文显示正常印出来变成小方块或空白。 原因客户端缺少对应字体或者模板里的文本指令没显式指定中文字体控件用默认西文字体回退失败。 解决给 ADD_PRINT_TEXT 之后紧跟 SET_FONT强制指定宋体或黑体写法是LODOP.ADD_PRINT_TEXT(120, 80, 800, 40, 订单号 order.no); LODOP.SET_FONT(宋体, 11, 0, 0, 0);。同时确认客户端系统里装了该字体瘦身过的 Windows 系统要检查。模板里能用英文就少写中文表头固定中文数据里别混入全角符号。4.2 坐标偏移预览和实际出纸对不上现象预览整体在中间打印出来整体向右下偏移 3 到 5mm。 原因打印机驱动里开了纸张缩放或者驱动默认的信纸类型是 Letter 而不是 A4。Lodop 按 A4 排版驱动按 Letter 出纸整体平移。 解决先到打印机首选项里把纸张类型改成和模板一致关掉“按纸张大小缩放”再用资源包里的模板打一张 10mm 间隔的坐标校准页拿尺子量实际偏差把偏差值换算成 0.1mm 补到模板的起始坐标上。这是唯一靠谱的校正办法靠肉眼调三个晚上都是玄学。4.3 Chrome 装完控件还是提示未安装现象IE 下打印正常Chrome 或 Edge 下 getLODOP() 永远返回 undefined重装多次也一样。 原因新浏览器对本地打印扩展的权限要求更高安装包装完不等于扩展启用也不等于站点被允许调用。 解决打开浏览器扩展管理页确认打印扩展状态把访问地址IP 或域名加入允许调用本地控件的白名单项目要长期跑考虑换成 C-Lodop 云打印模式同一套 JS 指令基本不用改只换安装和加载方式。测试时用 127.0.0.1 访问能通换成局域网 IP 又不通先查白名单。4.4 打印件底部带水印现象预览和打印件底部有一行很小的版权字样客户不愿意这样的单据直接交付。 原因这类控件存在免费调试模式未授权时默认会在任务里带水印位置一般在纸张底部边缘。 解决测试阶段无所谓正式上线前走正版授权或者在布局时把内容高度控制在纸张底部水印区之上。如果内容高度已经顶到边界说明该换更大纸张或者拆成两页了。这个坑上线前才发现会很尴尬建议第一次验收时就拿正式纸张看完整效果。4.5 直接打印没反应现象PREVIEW 有反应换成 PRINT 后没有预览、纸也不出来。 原因PRINT 在循环里被浏览器当成弹窗拦截或者静默参数没设置。 解决把打印动作放在用户点击事件里不要在页面加载时自动 PRINT批量场景显式加LODOP.SET_PRINT_MODE(PRINT_MODE_NO_PREVIEW, true)让控件静默出纸。这个模式调试阶段不要开开了就看不到错误提示了。提示调试打印不要每次都浪费纸预览框里通常有“另存为 PDF”或“打印到文件”的选项先存 PDF 看排版。5. 批量打印与静默打印一次任务处理 200 张单据批量打印是订单后台、进销存里最常见的需求。看起来是循环实际有几个只会在第几十张之后爆出来的细节。第一LODOP 对象取一次复用。循环里反复调用 getLODOP() 在部分浏览器中等于每次做一次控件重连几十次循环后开始变慢。正确写法是循环外取一次循环内只换 PRINT_INIT 的任务名。任务名里带上循环序号避免同名任务排队时互相覆盖。第二静默打印要显式设模式。批量出纸通常不想每张都弹预览循环前调用一次LODOP.SET_PRINT_MODE(PRINT_MODE_NO_PREVIEW, true)。但开发期第一张最好还是走 PREVIEW。我给模板加了一个调试参数URL 带 preview1 时第一张走预览跑批时去掉验证效率和排错都不耽误。var LODOP getLODOP(); var rows document.querySelectorAll(.order-row); LODOP.SET_PRINT_MODE(PRINT_MODE_NO_PREVIEW, true); rows.forEach(function (row, i) { LODOP.PRINT_INIT(单据_ row.dataset.no _ i); LODOP.SET_PRINT_PAGESIZE(1, 2100, 2970, A4); LODOP.ADD_PRINT_TEXT(120, 80, 800, 40, 订单号 row.dataset.no); LODOP.ADD_PRINT_TEXT(170, 80, 1200, 40, 品名 row.dataset.name); LODOP.PRINT(); });这段代码用同一个实例循环出纸。每轮循环都重新 PRINT_INIT不能只在初始化一次之后反复 ADD任务名不重复驱动才不会串队列。指定打印机用LODOP.SET_PRINTER_INDEX(打印机名称)打印服务器上有多个默认打印机时非常有用。名称必须与系统显示的一致含特殊符号的打印机名最好复制而不是手敲。这个参数写错不会报错只是纸永远从默认那台出来排查时第一时间看它。从那以后我每次接打印模块都强制走一遍流程装控件、跑最小测试页、印坐标校准页、改模板、先预览一张再放量。看起来多花十分钟实际上把后面的排查时间省掉一大半。希望帮到你。本文还有配套的精品资源点击获取