Go quotedprintable.Writer 的 Binary 模式有什么区别

我第一次用 mime/quotedprintable 包处理带换行的字节流时，真正困惑的不是等号编码，而是同一组 CR、LF 在输出里为什么会变成不同的形式。结论很明确：Writer.Binary=false 把换行当作文本行结束处理，写出时会规范化为 CRLF；Binary=true 则把输入中的 \r 和 \n 当成普通字节，分别编码成 =0D 和 =0A。

普通模式先规范化换行，Binary 模式再编码原始字节

官方文档对 Binary 的定义很短：开启后，writer 会把输入视为纯二进制，并把行尾字节当作二进制数据处理。源码中的关键判断是：当 Binary 为假时，\r、\n 会留给换行处理逻辑；当它为真时，这两个字节会走普通的十六进制编码路径。

因此，Binary 模式不是让输出直接出现原始换行。quoted-printable 的目标仍是把不可直接放入文本行的字节表示为 =XX；它只是确保解码后仍能区分原始的 CR 和 LF。

用最小程序对照两种输出

为了避免凭肉眼判断，我通常会把三种行尾样本放进同一个小程序。下面的打印结果是对输出字符串的转义展示，便于看见实际的 \r、\n 和 =0D、=0A。

package main

import (
    "bytes"
    "fmt"
    "mime/quotedprintable"
)

func encode(sample []byte, binary bool) string {
    var buf bytes.Buffer
    w := quotedprintable.NewWriter(&buf)
    // Binary=true 保留裸 CR/LF 的字节差异；文本模式允许换行规范化。
    w.Binary = binary
    // Write 可能只写入内部缓冲区，Close 用来冲刷最后一段数据。
    _, _ = w.Write(sample)
    _ = w.Close()
    return buf.String()
}

func main() {
    samples := [][]byte{
        []byte("A\nB"),
        []byte("A\rB"),
        []byte("A\r\nB"),
    }
    for _, sample := range samples {
        // %q 会把不可见换行显示成转义形式，方便逐字节比较。
        fmt.Printf("input=%q text=%q binary=%q\n", sample, encode(sample, false), encode(sample, true))
    }
}

对照时可以把注意力放在行尾，不要把输出中的 \r\n 误认为输入一定就是 CRLF。文本模式的三个样本都会走统一的 CRLF 写出路径；Binary 模式则分别显示 =0A、=0D 或 =0D=0A。另一个容易遗漏的点是 Close：官方实现明确说明它会刷新尚未写出的内容，但不会替调用方关闭底层的 io.Writer。

换行之外，Binary 不会取消 quoted-printable 的其他规则

把 Binary=true 理解成“原样透传”会产生第二个坑。等号仍要编码成 =3D，空格和制表符在行尾仍需要在收尾时编码，编码行长度仍受 76 个字符限制；超过限制时，writer 会插入软换行 =\r\n。这些规则与是否把 CR/LF 当作数据是两条独立的逻辑。

实际项目里，我会先问一个很具体的问题：解码方是否必须得到原始的单独 CR 或 LF？如果只是普通配置文本、日志片段或邮件正文一类允许文本换行规范化的内容，保持默认的 Binary=false 更容易阅读；如果字节级回放、协议字段或跨系统传输需要区分这三种输入，就把 Binary 设为 true，并用对照样本做回归。

按数据边界选择模式

可以把决策压缩成一张检查清单：① 输入是文本语义，换行差异没有业务意义，使用默认模式；② 输入是字节语义，单独 CR/LF 不能被改写，使用 Binary 模式；③ 无论哪种模式，都检查 Write 的错误并调用 Close；④ 如果下游还要求固定的行长或协议包装，再单独验证 76 字符软换行，不要把它归因于 Binary。

这也是我对这个字段最实用的理解：它不是一个“编码开关”，而是一个“换行语义开关”。先确定数据边界，再决定是否允许文本规范化，代码会比事后比较整段输出更可靠。

相关问题

Binary=true 会让 Writer 不再插入 CRLF 吗？

不会。输入中的 CR/LF 会被编码为 =0D 或 =0A，而 76 字符限制触发的软换行仍可能写出 =\r\n。

只调用 Write 不调用 Close 可以吗？

不建议。Writer 会缓存尚未完整写出的片段，Close 负责检查尾部空白并冲刷最后数据，但不会关闭你传入的底层 writer。

Binary 模式适合所有二进制文件吗？

它只解决换行字节的编码语义，不替你设计整个传输协议。还要确认接收方支持 quoted-printable，并单独考虑大小、行长和错误处理。