Go 的 json.Encoder.Encode() 方法会在每次编码后主动追加一个 \n 换行符，这是明确的、有文档说明的设计行为（非 bug），旨在支持流式 JSON 编码与安全分隔，而非美化输出。
go 的 `json.encoder.encode()` 方法会在每次编码后**主动追加一个 `\n` 换行符**，这是明确的、有文档说明的设计行为（非 bug），旨在支持流式 json 编码与安全分隔，而非美化输出。
在 Go 标准库中，json.Encoder 与 json.Marshal 承担着截然不同的职责：前者面向流式（streaming）场景，后者面向单次完整序列化。这一根本差异直接解释了为何 Encoder.Encode() 会强制附加换行符。
查看 Go 源码（encoding/json/stream.go）中的关键注释与实现：
// Encode writes the JSON encoding of v to the stream,
// followed by a newline character.
//
// See the documentation for Marshal for details about the
// conversion of Go values to JSON.
func (enc *Encoder) Encode(v interface{}) error {
// ... 序列化逻辑 ...
// Terminate each value with a newline.
// This makes the output look a little nicer
// when debugging, and some kind of space
// is required if the encoded value was a number,
// so that the reader knows there aren't more
// digits coming.
e.WriteByte('\n')
if _, err = enc.w.Write(e.Bytes()); err != nil {
enc.err = err
}
// ...
}
这段代码清晰表明：换行符是有意为之的终止符（delimiter），其核心价值体现在两方面：
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
流式解析可靠性
当连续调用 encoder.Encode(v1); encoder.Encode(v2); encoder.Encode(v3) 向同一 io.Writer（如文件、网络连接或管道）写入多个 JSON 值时，每个值后紧跟的 \n 构成了天然的消息边界。下游解析器可据此逐行读取并独立解码——这正是 JSON Lines（.jsonl）格式的核心约定。若无此分隔，相邻数字（如 42 和 3.14）可能被误读为 423.14，字符串也可能因缺乏明确切分而解析失败。安全性与可组合性
json.Marshal 返回完整字节切片，适用于小数据、内存可控场景；而 Encoder 设计用于处理未知长度的数据流（如日志事件、传感器批量上报、大文件导出）。它不假设上下文，而是通过 \n 提供最小可行的帧同步机制，避免因缓冲区管理不当导致的粘包或截断问题。
⚠️ 注意事项：
- 若你不需要换行符（例如拼接进 HTTP 响应体、嵌入 HTML 属性或生成紧凑 JSON），请勿直接使用 Encoder；改用 json.Marshal 或手动包装 Encoder 并截断末尾 \n（不推荐，破坏设计契约）。
- 若需生成多行 JSON（JSON Lines），务必使用 Encoder —— 它是标准、高效且符合 RFC 的方式。
- 切勿将 Encoder 输出直接 json.Unmarshal；应使用 json.Decoder 配合 bufio.Scanner 或按行读取，以正确识别 \n 边界。
总结而言，json.Encoder 的换行符不是“多余字符”，而是流式 JSON 协议的基础设施。理解这一点，便能恰当地选择工具：用 Marshal 处理静态结构，用 Encoder/Decoder 构建可扩展、可运维的 JSON 流管道。
