Go bytes.CutSuffix 的固定后缀判断方案

bytes.CutSuffix 可以一次完成“判断末尾是否为固定字节序列”和“取得去掉该后缀的部分”。使用 before, found := bytes.CutSuffix(src, suffix)，以 found 判断是否匹配；不要用返回切片是否为空来代替匹配判断。它只去掉末尾一次精确匹配，并返回原切片的视图，不复制剩余字节。

官方地址：https://pkg.go.dev/bytes

最小写法保留匹配标志

假设一批消息以固定的 .done 标记结尾，业务只想接收带标记的消息，并处理标记之前的主体。把“找到标记”和“剩下多少内容”分别表达，会比先改切片再猜是否成功更清楚。

src := []byte("job-42.done")
before, found := bytes.CutSuffix(src, []byte(".done"))
if !found {
    // 未匹配时 before 仍是原输入；此分支按业务处理缺少标记的情况。
    return
}
// 在当前作用域中使用 before；其内容按接口语义为 job-42。
_ = before

这是放在函数内使用的最小片段，所在文件需要导入 bytes。若输入是 job-42.done.tmp，中间虽然出现 .done，仍然不匹配末尾标记。未匹配时返回原输入与 false，而不是自动报错；是否拒绝该数据由调用方决定。

区分字节后缀与字符集合

固定后缀是一个完整的有序字节序列。CutSuffix 不把参数理解成字符集合，不忽略大小写，也不会自动跳过尾部空白。例如 .DONE 与 .done 不相等，job.done 的末尾是空格，同样不匹配 .done。业务如果需要清理空白，应明确先后规则，不能把清理悄悄塞进固定后缀判断。

常见误用是拿 TrimRight 做同一件事。TrimRight 的第二个参数是字符集合，它可能连续移除属于集合的多个尾部字符；TrimSuffix 才是固定后缀语义，但没有额外的 found 返回值。只问“是否匹配”可以用 HasSuffix；既要判断又要取得前半部分，用 CutSuffix 更直接。

处理空后缀和重复后缀

空后缀匹配成功，返回原切片与 true；nil 后缀也按长度为零处理。如果后缀来自外部配置，而业务不允许空标记，应在调用前拒绝空值。不要写一个以 found 为唯一退出依据的重复删除循环，再让空后缀进入其中：结果长度不会减少，循环可能永远不结束。

对于 a.done.done，调用一次只去掉最后一个 .done，主体仍为 a.done。这是固定后缀函数的预期语义。若协议只允许一个结束标记，应按协议检查主体，而不是无条件反复剥离。

表格是根据接口语义整理的示例推演，不是本地运行输出。输入恰好等于后缀时，空主体仍然是匹配成功；主体是否允许为空，应作为另一个业务条件处理。

决定返回视图还是独立副本

CutSuffix 不会修改 src 的字节，也不会把 src 变量本身缩短，但 before 与 src 通常引用同一个底层数组。通过 before 修改共有范围内的字节，会影响从 src 观察到的内容。如果输入缓冲将被复用，或者结果要放入长期缓存，应复制主体。

// 已处理 found 后，用 Clone 取得独立字节存储。
owned := bytes.Clone(before)
// 只限制 append 容量时可以用完整切片表达式，但这并非复制。
limited := before[:len(before):len(before)]
_ = owned
_ = limited

限制容量可以避免后续 append 借用原数组的剩余空间覆盖被切掉的后缀，但不会隔离对现有元素的直接修改。想让结果拥有独立所有权，应选择 Clone，而不是把限制容量当成数据复制。缓存一个很短的视图也可能使大型输入数组继续存活；复制小主体可以解除这种保留关系。

形成可复用业务函数

下面把固定 .done 后缀、非空主体和独立结果三条约定集中在一个函数中。它适用于调用方会继续改写输入缓冲，而消费者还要保存主体的情况；如果消费者只在当前只读作用域内使用数据，可按生命周期约定省去 Clone。

package suffix

import (
    "bytes"
    "fmt"
)

// StripDone 只接受以固定标记 .done 结尾且主体不为空的记录。
// 成功结果拥有独立存储，不依赖调用方输入缓冲的后续复用。
func StripDone(src []byte) ([]byte, error) {
    before, found := bytes.CutSuffix(src, []byte(".done"))
    if !found {
        return nil, fmt.Errorf("缺少 .done 后缀")
    }
    if len(before) == 0 {
        // 匹配成功与主体有效是不同的业务条件。
        return nil, fmt.Errorf("主体不能为空")
    }
    return bytes.Clone(before), nil
}

该函数把库级语义和业务规则分开：CutSuffix 给出匹配状态，函数决定错误策略，Clone 决定存储归属。没有必要先转成 string 再转回来；输入本来就是字节切片时，保留字节接口能让所有权约定更清楚。

中文后缀可以直接使用吗？

可以传入中文文本编码后的字节，但匹配依据仍是字节相等。它不会处理 Unicode 规范化或模糊等价；看起来相同而编码序列不同的内容不能据此认为相等。

nil 输入配空后缀怎样判断？

空后缀匹配成功，返回原输入。不要把 nil 或长度零当成 found 的替代值。

旧项目找不到 CutSuffix 怎么办？

该接口从 Go 1.20 提供。受工具链约束时可以先用 HasSuffix，再在匹配分支按后缀字节长度切片；不要先减长度后切片而省略匹配判断。

技术资料：Go bytes 文档；bytes 官方实现。