Go net/textproto.Reader.ReadDotLines 怎样把点终止正文读成多行字符串
我第一次接触点终止正文时,最容易犯的错是把它当成普通的逐行读取:读到一行 . 就自己停止,再手动去掉行尾换行。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)。每一项代表一行,行尾换行不保留;终止行只负责告诉读取器正文在哪里结束。这个能力的价值不在于少写一个循环,而在于把终止标记、点转义和换行归一化放到同一个协议实现里。

为什么要先创建 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、ReadDotBytes 和 DotReader 怎么选
这三个 API 都围绕 dot-encoding,但结果形态不同。可以按最终处理方式选择:
| API | 返回形态 | 更适合的场景 |
|---|---|---|
ReadDotLines | []string | 正文天然按行处理,需要直接遍历文本行 |
ReadDotBytes | []byte | 需要拿到完整解码字节,再交给 JSON、MIME 或其他解析器 |
DotReader | io.Reader | 正文较大,或希望边读边消费解码后的流 |
对我来说,判断标准很简单:如果下一步就是按行找字段,使用 ReadDotLines;如果下一步依赖原始字节,使用 ReadDotBytes;如果不想一次把正文聚合进切片,考虑 DotReader。注意 DotReader 返回的读取器只在对 Reader 的下一次方法调用前有效,不能把它当成可以长期保存的独立对象。
最小核对清单与常见问题
- 输入是否包含单独的
.\r\n或.\n终止行? - 正文中原本以点开头的行,传输时是否按点编码规则增加了一个点?
- 是否检查了
error,没有把不完整切片当成成功正文? - 网络来源是否有合理的读取上限,避免无界正文?
ReadDotLines 会保留每行末尾的换行吗?不会。官方文档说明,返回切片的每一行都会去掉最后的 \r\n 或 \n。
如果只想处理原始字节怎么办?使用 ReadDotBytes;它同样先解码点编码,但结果是完整的 []byte。
没有终止点时能否把当前切片当成功?不建议。点终止正文的边界本身就是协议的一部分,应该把底层返回的错误交给上层处理。
这次把 ReadDotLines 用熟后,我会把它定位成“协议解码入口”,而不是“更方便的字符串切分函数”:它负责点编码和终止边界,业务代码负责正文格式、字段语义和长度策略。边界分清楚,后续遇到 SMTP 或其他文本协议的多行正文时,就不必再手写一套相似的结束判断。
JetBrains Copilot 加入远程访问后,开发者怎样理解本地与远端入口
- 上一篇
- JetBrains Copilot 加入远程访问后,开发者怎样理解本地与远端入口
- 下一篇
- Go go/token.Token.IsLiteral 怎样区分字面量记号与运算符
-
- Golang · Go问答 | 30分钟前 | 网络编程 · go · Go net/textproto Reader.ReadResponse 多行响应
- Go net/textproto.Reader.ReadResponse 怎样读取带续行的协议响应
- 260浏览 收藏
-
- Golang · Go问答 | 37分钟前 | go · Go text/scanner 词法扫描 Scanner.TokenText 记号文本
- Go text/scanner.Scanner.TokenText 怎样保留当前记号的原始文本
- 360浏览 收藏
-
- Golang · Go问答 | 43分钟前 | go · regexp · Go 正则匹配 index/suffixarray FindAllIndex 字节区间
- Go index/suffixarray.Index.FindAllIndex 怎样返回正则匹配的字节区间
- 238浏览 收藏
-
- Golang · Go问答 | 52分钟前 | 标准库 · 数据一致性 · Go问答 · Go 原始数据 index/suffixarray Index.Bytes 后缀数组 索引持久化
- Go index/suffixarray.Index.Bytes 怎样取得索引引用的原始数据
- 501浏览 收藏
-
- Golang · Go问答 | 1小时前 | 数据结构 · 标准库 · go · Go container/ring Ring.Move 环形指针
- Go container/ring.Ring.Move 怎样按正负偏移移动环形指针
- 377浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · 文件系统 · Go ReadDir testing/fstest MapFS
- Go testing/fstest.MapFS.ReadDir 怎样列出内存文件系统的直接子项
- 122浏览 收藏
-
- Golang · Go问答 | 1小时前 | 单元测试 · go · Go io.Reader 短读取 testing/iotest HalfReader
- Go testing/iotest.HalfReader 怎样模拟每次只能读取部分数据的输入
- 424浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · Go debug/gosym NewLineTable runtime.text
- Go debug/gosym.NewLineTable 怎样用行号数据和文本段基址构造映射表
- 343浏览 收藏
-
- Golang · Go问答 | 1小时前 | go · 调试 · Go 符号表 debug/gosym NewTable LineTable
- Go debug/gosym.NewTable 怎样组合符号表字节与行号表创建查询对象
- 116浏览 收藏
-
- Golang · Go问答 | 1小时前 | Go问答 · Go 符号表 debug/gosym gosym.Table.LookupFunc 函数名称
- Go debug/gosym.Table.LookupFunc 怎样根据函数名称查询符号表
- 436浏览 收藏
-
- Golang · Go问答 | 1小时前 | Go教程 · Go index ELF debug/elf VersionIndex 动态符号
- Go debug/elf.VersionIndex.Index 怎样取得不含标记位的符号版本索引
- 190浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1095次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1092次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1256次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1197次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1046次使用
-
- Go map 并发写 panic 怎么办:从共享 map 到可控写入路径
- 2026-06-30 123浏览
-
- go语言中的defer关键字
- 2023-02-17 150浏览
-
- Golang中Interface接口的三个特性
- 2023-01-07 394浏览
-
- go语言中函数与方法介绍
- 2023-01-07 297浏览
-
- go语言数据类型之字符串string
- 2022-12-30 321浏览

