登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go问答

Go net/textproto.Reader.ReadDotLines 怎样把点终止正文读成多行字符串

来源:17golang原创

时间:2026-11-18 15:28:05 463浏览 收藏

我第一次接触点终止正文时,最容易犯的错是把它当成普通的逐行读取:读到一行 . 就自己停止,再手动去掉行尾换行。Go 的 net/textproto.Reader.ReadDotLines 已经把这套协议边界封装好了。只要输入是 dot-encoding,它会返回解码后的 []string,每个元素末尾的 \r\n 或 \n 都已经去掉,单独的终止点也不会进入结果。

一句话结论:先用 bufio.NewReader 包住协议输入,再用 textproto.NewReader 创建读取器,调用 ReadDotLines();如果正文很大或来自网络,要先给底层读取设置长度上限。

点终止正文的变化:从“自己找点号”变成直接拿解码后的行

点编码正文的结束形状是单独一行 .\r\n。正文里如果确实有一行以点开头,就会额外写一个点来转义,例如传输中的 ..hello\r\n,解码后应当是 .hello。因此,调用方真正想要的通常不是协议原文,而是已经还原的多行文本。

ReadDotLines 适合这个结果模型:输入是一个 *textproto.Reader,返回 ([]string, error)。每一项代表一行,行尾换行不保留;终止行只负责告诉读取器正文在哪里结束。这个能力的价值不在于少写一个循环,而在于把终止标记、点转义和换行归一化放到同一个协议实现里。

Go ReadDotLines 输入的点编码、终止行和解码行集合结构说明图
图1:点编码输入、终止边界和 ReadDotLines 返回行集合的静态说明图,不是运行截图。

为什么要先创建 bufio.Reader,再调用 ReadDotLines

textproto.NewReader 的参数不是任意 io.Reader,而是 *bufio.Reader。最小写法如下,示例用内存字符串模拟一段已经按协议写好的正文:

package main

import (
    "bufio"
    "fmt"
    "strings"

    "net/textproto"
)

func main() {
    // 单独的点行结束正文;两个点表示解码后保留一个行首点。
    encoded := "Subject: demo\r\n..leading-dot\r\nbody\r\n.\r\n"
    reader := textproto.NewReader(bufio.NewReader(strings.NewReader(encoded)))

    lines, err := reader.ReadDotLines()
    if err != nil {
        // 网络输入可能提前断开,错误必须交给上层决定是否重试或终止。
        panic(err)
    }

    // 这里拿到的是去掉行尾换行并完成点解码后的正文行。
    fmt.Printf("%q\n", lines)
}

按文档语义,这段数据对应的结果应理解为三行:Subject: demo、.leading-dot 和 body。不要把传输中的 ..leading-dot 当成业务正文,也不要把最后的 . 拼进字符串。

如果输入来自连接,创建读取器时还要考虑响应大小。Go 文档特别提醒,传给 NewReader 的 bufio.Reader 最好建立在 io.LimitReader 或类似限制之上,避免对端持续发送超大正文占用内存:

// maxBodyBytes 是业务允许的正文上限,数值应由协议和业务共同确定。
const maxBodyBytes = 1 

上面的片段需要额外导入 io,并把 conn 替换成实际的网络读取源。长度限制不是 ReadDotLines 的参数,而是读取器外层的资源边界;这也是它和业务正文校验应当分开的地方。

返回值和错误:不要把它当成普通 ReadLine 循环

我觉得这个方法最容易被低估的地方,是它同时处理了“读到哪儿”和“读成什么样”。普通 ReadLine 只负责一行,调用方需要自己规定结束条件;ReadDotLines 则会持续读取 dot-encoding,遇到单独点行结束,并把解码后的行放进切片。

调用方应当先判断 error,再把 lines 交给后续解析。网络中途断开、输入格式不完整或底层读取失败时,返回的切片不能自动代表一份可提交的完整正文。一个更适合业务代码的封装可以这样写:

func readBody(r io.Reader) ([]string, error) {
    // 统一在这里建立缓冲读取器,调用者只关心协议正文和错误。
    textReader := textproto.NewReader(bufio.NewReader(r))
    lines, err := textReader.ReadDotLines()
    if err != nil {
        // 不返回半成品,避免上层误把截断正文当作成功结果。
        return nil, fmt.Errorf("read dot body: %w", err)
    }
    return lines, nil
}

这里的 nil 不是说正文一定为空,而是明确表示读取失败。若业务需要保留部分数据用于诊断,可以单独记录上下文,但不要因此省略错误判断。

ReadDotLines 与 bufio.Reader、错误处理和长度限制之间的关系结构说明图
图2:Reader、长度边界、ReadDotLines 返回值与错误处理的静态关系图,不是运行截图。

ReadDotLines、ReadDotBytes 和 DotReader 怎么选

这三个 API 都围绕 dot-encoding,但结果形态不同。可以按最终处理方式选择:

API返回形态更适合的场景
ReadDotLines[]string正文天然按行处理,需要直接遍历文本行
ReadDotBytes[]byte需要拿到完整解码字节,再交给 JSON、MIME 或其他解析器
DotReaderio.Reader正文较大,或希望边读边消费解码后的流

对我来说,判断标准很简单:如果下一步就是按行找字段,使用 ReadDotLines;如果下一步依赖原始字节,使用 ReadDotBytes;如果不想一次把正文聚合进切片,考虑 DotReader。注意 DotReader 返回的读取器只在对 Reader 的下一次方法调用前有效,不能把它当成可以长期保存的独立对象。

最小核对清单与常见问题

  • 输入是否包含单独的 .\r\n 或 .\n 终止行?
  • 正文中原本以点开头的行,传输时是否按点编码规则增加了一个点?
  • 是否检查了 error,没有把不完整切片当成成功正文?
  • 网络来源是否有合理的读取上限,避免无界正文?

ReadDotLines 会保留每行末尾的换行吗?不会。官方文档说明,返回切片的每一行都会去掉最后的 \r\n 或 \n。

如果只想处理原始字节怎么办?使用 ReadDotBytes;它同样先解码点编码,但结果是完整的 []byte。

没有终止点时能否把当前切片当成功?不建议。点终止正文的边界本身就是协议的一部分,应该把底层返回的错误交给上层处理。

这次把 ReadDotLines 用熟后,我会把它定位成“协议解码入口”,而不是“更方便的字符串切分函数”:它负责点编码和终止边界,业务代码负责正文格式、字段语义和长度策略。边界分清楚,后续遇到 SMTP 或其他文本协议的多行正文时,就不必再手写一套相似的结束判断。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>