Go bytes.Buffer Truncate 怎样丢弃前缀内容

如果你把一段数据先读掉头部，再想让 bytes.Buffer 只保留当前有效内容，最容易写错的是把 Truncate(n) 当成“从开头删除 n 个字节”。它实际作用于未读部分：保留未读区的前 n 个字节，丢弃未读区后面的内容。要消费前缀，应先用 Read 或 Next 推进读取位置。

官方资料：https://pkg.go.dev/bytes#Buffer.Truncate

记忆方式：Read/Next 决定未读窗口从哪里开始，Truncate 决定这个窗口保留多长；如果要全部清空，直接使用 Reset。

先看清 Truncate 截断的是哪一段

bytes.Buffer 同时维护底层存储和未读窗口。写入 prefix|payload|tail 后，三段内容都属于未读数据；如果先消费 prefix|，未读窗口就变成 payload|tail。此时调用 Truncate(7)，保留的是未读窗口前 7 个字节，也就是 payload，被丢弃的是后面的 |tail。

因此，标题里所说的“丢弃前缀”不能只靠 Truncate 完成。前缀消费和尾部截断是两个独立动作；把它们混在一起，通常会得到长度正确但内容错误的缓冲区。

先用 Read 或 Next 消费前缀，再截断尾部

下面的例子把两步写在一起：Next 负责消费已经处理的协议头，Truncate 负责把未读窗口裁到正文长度。示例只演示对象关系和参数含义，关键是先推进读取位置，再计算当前未读长度。

package main

import (
    "bytes"
    "fmt"
)

func keepPayload() string {
    buffer := bytes.NewBufferString("prefix|payload|tail")

    // Next 消费协议前缀；返回的切片只在后续修改前使用。
    prefix := buffer.Next(len("prefix|"))
    if string(prefix) != "prefix|" {
        // 前缀不匹配时应停止处理，避免把错误数据当成正文。
        return "invalid prefix"
    }

    // Truncate 保留未读窗口的前 7 个字节，丢弃窗口尾部的 "|tail"。
    buffer.Truncate(len("payload"))
    // String 读取当前未读部分，得到裁剪后的正文。
    return buffer.String()
}

func main() {
    // 这里展示裁剪后的正文；实际业务应根据协议决定失败处理。
    fmt.Println(keepPayload())
}

这段代码里，Next 返回的 prefix 只是被立即检查，没有跨越后续修改继续保存。Truncate 的参数使用当前协议已知的正文长度；如果正文长度来自不可信输入，应先把它限制在 0 到 buffer.Len() 之间。

三个边界：参数、Reset 和 Bytes 切片

第一，Truncate 的 n 不能为负数，也不能大于当前未读长度，否则会触发 panic。第二，Reset() 等价于 Truncate(0)，会让未读内容变为空，但仍保留已分配的底层存储供后续写入使用。第三，Bytes() 返回的是当前未读部分的别名切片，后续读写、Reset 或 Truncate 后不要把它当作稳定快照。

// truncateSafely 把外部长度约束在当前未读窗口内，避免参数越界。
func truncateSafely(buffer *bytes.Buffer, n int) bool {
    // 先读取当前未读长度，再判断负数和过大值。
    if n  buffer.Len() {
        return false
    }
    // 调用前已完成边界判断，Truncate 只负责保留未读区前 n 字节。
    buffer.Truncate(n)
    return true
}

// clearForReuse 清空内容，但不把旧 Bytes 切片继续交给调用方。
func clearForReuse(buffer *bytes.Buffer) {
    // Reset 等价于 Truncate(0)，适合下一轮重新写入。
    buffer.Reset()
}

按目标选择 Buffer 操作

如果数据格式是“已消费头部 + 当前正文 + 多余尾部”，最清晰的组合就是先消费头部，再根据正文边界调用 Truncate。如果只是想清空对象，不要用复杂的长度计算，直接 Reset；如果要把内容交给异步任务，先复制 Bytes()，不要把别名切片跨修改传出去。

相关问题

Truncate(0) 和 Reset 有什么区别？对 bytes.Buffer 的内容效果相同，Reset 更直接地表达“清空后复用”的意图。

Truncate 能删除未读区的前 n 个字节吗？不能。它保留未读区前 n 个字节；要消费前缀，应使用 Read 或 Next。

为什么 Truncate 后容量没有变小？该方法继续使用同一块已分配存储，减少长度不等于主动释放容量；这正是 Buffer 适合复用的一部分原因。