10分钟上手node-escpos：从安装到打印的快速入门教程

【免费下载链接】node-escpos 🖨️ ESC/POS Printer driver for Node.js 项目地址: https://gitcode.com/gh_mirrors/no/node-escpos

node-escpos是一款功能强大的ESC/POS打印机驱动库，专为Node.js环境设计，让你轻松实现与各类热敏打印机的通信和控制。本教程将带你快速掌握从安装到基本打印的全过程，即使是新手也能在10分钟内完成首次打印。

快速安装指南

开始使用node-escpos非常简单，只需通过npm或yarn包管理器即可完成安装。打开终端，执行以下命令之一：

npm install escpos
# 或者
yarn add escpos

连接打印机的3种方式

node-escpos支持多种连接方式，你可以根据自己的打印机类型选择合适的连接方法：

USB连接（最常用）

const escpos = require('escpos');
const device  = new escpos.USB(); // 自动检测USB打印机

网络连接

// const device  = new escpos.Network('localhost'); // 替换为打印机IP

串口连接

// const device  = new escpos.Serial('/dev/usb/lp0'); // 根据实际串口路径调整

首次打印体验

完成设备连接后，让我们来创建一个简单的打印任务。以下代码将打印一段欢迎文本并执行切纸操作：

const options = { encoding: "GB18030" }; // 支持中文编码
const printer = new escpos.Printer(device, options);

device.open(function(err){
  printer
    .font('a')                 // 设置字体
    .align('ct')               // 居中对齐
    .size(1, 1)                // 字体大小
    .text('欢迎使用node-escpos') // 打印文本
    .text('这是你的第一份打印')
    .cut()                     // 切纸
    .close();                  // 关闭连接
});

常用打印功能

node-escpos提供了丰富的打印功能，满足各种场景需求：

文本格式化

• font('a'|'b'): 切换字体
• align('lt'|'ct'|'rt'): 文本对齐（左/中/右）
• size(width, height): 调整字体大小（1-8）

条码与二维码

通过barcode()方法可以轻松打印各种类型的条码，满足商品标签等场景需求。

高级控制

• cut(): 切纸操作
• beep(n,t): 蜂鸣提示（次数和时长）
• cashdraw(pin): 控制钱箱

故障排除小贴士

如果遇到打印问题，可以尝试以下解决方法：

1. 连接问题：检查打印机是否正确连接并开机
2. 权限问题：确保Node.js进程有权限访问USB/串口设备
3. 编码问题：通过encoding选项设置正确的字符编码
4. 驱动支持：确认你的打印机支持ESC/POS指令集

深入学习资源

• 官方文档：docs/README.md
• 示例代码：examples/
• API参考：packages/printer/src/index.ts

通过本教程，你已经掌握了node-escpos的基本使用方法。这个强大的库还支持更多高级功能，如图片打印、屏幕控制等，等待你去探索。现在就连接你的打印机，开始体验便捷的打印编程吧！

【免费下载链接】node-escpos 🖨️ ESC/POS Printer driver for Node.js 项目地址: https://gitcode.com/gh_mirrors/no/node-escpos