Go语言中确保IO缓冲区完全写入ESC POS打印机的问题

这问题我之前折腾USB热敏打印机时也碰到过，核心原因和USB打印机的底层传输逻辑、缓冲机制有关，咱们一步步拆解来看：

为什么最后一行经常打不出来？ #

1. 缓冲层级的差异：你用bufio.Writer的Flush()只是把Go程序里的用户态缓冲数据刷到了操作系统内核，但内核到打印机硬件还有一层USB传输缓冲。如果程序紧接着退出（defer f.Close()在main结束时执行），内核可能还没把最后一行数据完全发送到打印机，程序退出后内核就中断了传输，导致最后一行丢失。
2. 打印机的触发逻辑：有些ESC POS打印机需要收到特定命令（比如换页、强制打印）才会把缓冲里的内容全部输出，单纯的换行\n可能只触发行缓冲，但如果最后一行数据量小，还没填满打印机的硬件缓冲，它就会等着，直到收到触发命令或者超时。
3. 定时器的本质作用：加定时器其实是给了内核和打印机足够的时间完成剩余数据的传输和打印，属于“笨办法但有效”，但不是最优解。

可行的解决方案 #

方案1：发送ESC POS强制打印命令（推荐） #

ESC POS协议里有专门的命令可以强制打印机输出所有缓冲内容，最常用的是换页命令\x0C，或者打印并走行命令\x1B\x64\x00（\x00表示走0行，只打印缓冲）。在最后一行之后加上这个命令，就能确保打印机立刻输出所有内容。

修改后的代码示例：

package main

import (
    "bufio"
    "os"
)

func main() {
    f, err := os.Create("/dev/usb/lp0")
    if err != nil {
        panic(err)
    }
    defer f.Close()

    w := bufio.NewWriter(f)
    // 初始化打印机
    _, err = w.Write([]byte("\x1B@"))
    if err != nil {
        panic(err)
    }

    // 写入测试内容
    lines := []string{
        "toto-1\n", "toto-2\n", "toto-3\n",
        "toto-4\n", "toto-5\n", "toto-6\n",
        "toto-7\n", "toto-8\n", "toto-9\n",
    }
    for _, line := range lines {
        _, err = w.WriteString(line)
        if err != nil {
            panic(err)
        }
    }

    // 发送强制打印命令（换页）
    _, err = w.Write([]byte("\x0C"))
    if err != nil {
        panic(err)
    }

    // 刷入内核缓冲
    err = w.Flush()
    if err != nil {
        panic(err)
    }
}

方案2：短暂延迟等待传输完成 #

如果不想用ESC命令，可以在Flush()之后加一个短暂的延迟（比如100ms），给打印机足够时间处理剩余数据，比加几秒定时器更高效：

// ... 前面代码不变
err = w.Flush()
if err != nil {
    panic(err)
}
// 等待100ms，确保数据发送到打印机
import "time"
time.Sleep(100 * time.Millisecond)

方案3：检查设备同步支持（可选） #

有些USB打印设备支持fsync()调用，你可以尝试在Flush()之后调用f.Sync()，但注意不是所有/dev/usb/lp0设备都支持这个操作，如果调用失败就跳过：

err = w.Flush()
if err != nil {
    panic(err)
}
// 尝试同步设备，失败则忽略
if err = f.Sync(); err != nil {
    println("Sync failed:", err.Error())
}

为什么写入普通文件没问题？ #

普通文件是块存储设备，Flush()之后数据就会被写入磁盘，程序退出不影响数据的持久化。但/dev/usb/lp0是字符设备，对应USB打印机的实时数据流，数据需要持续传输到硬件，程序退出后内核会终止未完成的传输，这就是两者的核心差异。

内容的提问来源于stack exchange，提问作者thomas