打印参数详解
pdfOptions 与 printOptions 字段对比、踩坑说明与热敏纸/A4/双面打印实战配方。
阅读专题Web打印专家开发文档
Web打印专家官方开发文档中心：涵盖 Lodop、window.print 等选型对比，Vue/React 等框架集成，小票/WMS/信创等业务场景，以及客户端部署与进阶配置等专题；配合 25 个在线样例 与下方 web-print-pdf API 参考，帮助前端快速落地 HTML 静默打印。
在线样例
25 个可运行 Demo：演示票据、演示小票、演示包裹贴、水印、批量打印。左侧选样例、右侧看代码，安装客户端后即可即点即打。
即点即打
进入样例
打开在线样例中心
在浏览器中直接运行 printHtml、批量打印、水印等 API 示例，无需本地搭建项目。
专题教程
按选型、框架、场景、进阶与部署分类；配合下方 API 与在线样例快速落地。
前端错误处理标准
客户端连不上、打印报错看不懂？getConnectStatus 预检、formatPrintError 统一提示与常见场景对照表。
阅读专题需登录权限的页面如何打印
printHtmlByUrl 如何通过 extraOptions 传入 cookies、httpHeaders、localStorage，打印受会话保护的业务 URL。
阅读专题远程打印配置
打印任务消息 JSON 格式固定；业务方自建接收、存储任务并暴露 WebSocket/HTTP 接口，工位客户端填写该地址后出纸（非网页 printHtml）。
阅读专题本地Print succeeded，上线后无法打印？
开发环境正常，线上 Console 报 WebSocket connection to ws://127.0.0.1:16794 failed？说明 Chrome 本地网络限制与 HTTPS / flags 两种方案。
阅读专题Lodop 与 web-print-pdf 选型
客观对比与决策矩阵；可与 Lodop 并行 PoC，精密套打可继续 Lodop。
阅读专题window.print 替代与静默打印原理
为什么浏览器无法静默打印、有哪些可行方案，以及 web-print-pdf 本地客户端如何实现无弹窗出纸。
阅读专题hiprint 与 web-print-pdf 选型对比
客观对比 hiprint 与 web-print-pdf；重点说明 web-print-pdf 在 Windows/macOS/Linux 信创全平台、npm 集成与 HTML 报表上的优势。
阅读专题C-Lodop 与 Chrome 兼容
浏览器升级后的环境排查清单；可与 Lodop 并行评估 HTML 打印。
阅读专题Lodop 并行接入 web-print-pdf
盘点 → PoC → 并行运行；可与 Lodop 共存，非一刀切替换。
阅读专题Print.js 与 web-print-pdf 对比
Print.js 对话框打印 vs 本地客户端静默打印，帮助 ERP/WMS 选型。
阅读专题jsPDF 与 web-print-pdf 对比
生成 PDF 文件 vs 直接驱动本地打印机静默出纸。
阅读专题Puppeteer / Playwright 打印对比
服务端 PDF/归档 vs 工位 PC 静默出纸；含决策矩阵与专题分工。
阅读专题Vue 静默打印
在 Vue 3 管理后台中调用 printHtml，实现无浏览器弹窗的静默打印。
阅读专题React 静默打印
在 React 18 管理后台中用 web-print-pdf 的 printHtml 实现无浏览器弹窗打印，含 Hook 示例。
阅读专题Next.js 静默打印
App Router / Pages Router 客户端组件中接入 printHtml，实现无浏览器弹窗打印。
阅读专题Angular 静默打印
Angular 15+ Service 封装 printHtml，管理后台 HTML 报表静默出纸。
阅读专题UniApp H5 静默打印
UniApp H5 + 桌面客户端；小程序场景与远程工位出纸说明。
阅读专题UI 组件库专题（选读）
Element Plus / Ant Design 与上方 Vue、React 集成思路相同，日常以框架专题为主即可。
WMS 远程面单打印
服务端推送面单、仓库 PC 自动静默出纸。
阅读专题热敏小票与快递面单打印
80mm 小票、WMS 面单与批量标签：HTML 版式 + printHtml / batchPrint，Win/Mac/Linux/信创同一套 API。
阅读专题医疗处方与药房标签打印
A4 处方笺与 Rx 标签：HTML 版式 + printHtml/batchPrint，链 prescription-a4、rx-labels 样例。
阅读专题ERP 发票与对账单打印
财务共享、增值税票与长表格对账单静默打印，链 invoice、order-table 样例。
阅读专题电商发货面单打印
100×150 面单与 batchPrint 波次，配合 WMS 远程推送。
阅读专题零售 POS 热敏小票
80mm 收银小票静默打印，链 receipt-80mm 样例与热敏专题。
阅读专题政务信创部署案例
麒麟/UOS 混合终端 HTML 报表 + Lodop 并行改造匿名摘要。
阅读专题物流 WMS 面单案例
服务端推送 + 仓库工位客户端批量面单匿名摘要。
阅读专题制造 ERP 车间案例
车间工单与办公室 A4 报表静默打印匿名摘要。
阅读专题银河麒麟静默打印
麒麟桌面 deb 客户端安装与 web-print-pdf 接入。
阅读专题统信 UOS 静默打印
UOS 桌面部署与政务内网打印场景。
阅读专题Windows 部署指南
Windows 10/11 安装 exe 客户端、防火墙与 WebSocket 联调、web-print-pdf 静默打印接入。
阅读专题macOS 部署指南
Apple Silicon / Intel Mac 安装 dmg 客户端，Gatekeeper 放行与 web-print-pdf 接入。
阅读专题Linux 部署指南
在银河麒麟、统信 UOS 等环境安装 deb 客户端并接入 web-print-pdf。
阅读专题Windows 防火墙排障
放行 exe 与回环 WebSocket，Windows 工位专用。
阅读专题API 概览
printHtml
打印 HTML 字符串。PDF 样式完全由 HTML/CSS 控制，适合动态生成的报表、票据、订单页。
printHtmlByUrl
打印在线 HTML 页面 URL，可配置 cookies、headers、超时等参数。
printHtmlByBase64
打印 Base64 编码的 HTML 内容。
batchPrint
批量提交多个打印任务，适合快递面单、发票等大批量场景。
远程打印（WebSocket / HTTP）
客户端实时监听远程服务端接口，通过 WebSocket 或 HTTP 轮询获取打印消息并自动输出。消息格式与 web-print-pdf npm 包一致，适合 ERP、WMS 等服务端推送打印任务。
printPdfByUrl / printImageByUrl
直接打印在线 PDF 或图片文件，支持指定打印机与份数。
更多 API 详见 GitHub 仓库 README。
API 与排障参考（选读）
需要查参数签名或排查 WebSocket 时再打开；日常接入以「进阶配置」专题为主。
常见问题
web-print-pdf 使用前需要安装什么？
必须先安装 Web打印专家客户端。npm 包仅提供 JavaScript API，打印能力由本地客户端提供。
如何在 Vue 项目中使用？
npm install web-print-pdf 后，在组件中 import 并调用 API，与调用普通 npm 库相同。
如何配置远程打印？
在客户端「远程打印配置」中选择 WebSocket 或 HTTP 轮询，填入远程服务端 URL。服务端推送的消息格式需与 web-print-pdf 一致，客户端收到后自动打印。