Go strings.CutPrefix 多个候选前缀按什么顺序判断

处理协议头、命令标记或路由前缀时，候选字符串经常会出现 go 和 go1 这种重叠。strings.CutPrefix 一次只判断一个前缀，不会自动替你决定多个候选的顺序。稳定做法是：重叠前缀按长度从长到短扫描；没有重叠时按业务优先级显式排列，并把匹配结果和剩余文本一起返回。

先看清 CutPrefix 能决定什么

它的签名是 after, found := strings.CutPrefix(s, prefix)。匹配成功时返回去掉前缀后的文本和 true；失败时返回原文本和 false。前缀是空字符串时，函数返回原文本但 found 为 true，所以空值不能被当作普通候选。

package main

import (
	"fmt"
	"strings"
)

func main() {
	input := "go1.26"
	after, ok := strings.CutPrefix(input, "go") // 只判断这一个前缀
	fmt.Println(after, ok)                       // 1.26 true
	unchanged, ok := strings.CutPrefix(input, "rust") // 未命中时保留原文
	fmt.Println(unchanged, ok)                         // go1.26 false
}

重叠前缀为什么要最长优先

如果候选是 go、go1，输入为 go1.26，先判断 go 会得到 1.26，随后已经失去判断 go1 的机会。这里的“最长优先”不是 CutPrefix 的内置规则，而是调用方为消除歧义制定的规则。

可以先把候选复制后按长度降序排列，再逐个调用 CutPrefix。排序只改变候选副本，不改变调用方的配置；如果业务本身有固定优先级，则不要偷偷排序，直接按配置顺序扫描。

把顺序写成可复用的解析函数

package main

import (
	"sort"
	"strings"
)

func cutLongest(s string, candidates []string) (string, string, bool) {
	list := append([]string(nil), candidates...) // 不改动调用方的候选配置
	list = filterNonEmpty(list)
	sort.SliceStable(list, func(i, j int) bool { return len(list[i]) > len(list[j]) }) // 长前缀先判断
	for _, prefix := range list {
		if after, ok := strings.CutPrefix(s, prefix); ok {
			return prefix, after, true // 同时返回命中的前缀，便于路由或日志记录
		}
	}
	return "", s, false // 没有命中时保留完整输入
}

func filterNonEmpty(in []string) []string {
	out := make([]string, 0, len(in))
	for _, item := range in {
		if item != "" { // 空前缀会无条件命中，配置中应明确排除
			out = append(out, item)
		}
	}
	return out
}

这段函数适合前缀之间存在包含关系的场景。若 cmd: 必须优先于 c: 是产品规则，则把排序换成按业务配置顺序遍历，并在配置测试中固定该顺序。

用这张表决定实际顺序

测试至少覆盖：长短前缀同时出现、候选完全不匹配、重复候选、空候选，以及命中后剩余文本为空。不要只断言剩余字符串，还要断言命中的前缀和布尔值，否则顺序错误很难被发现。

常见问题

CutPrefix 能一次传入多个前缀吗？

不能。它的第二个参数是一个字符串；多个候选需要由调用方遍历，并自行定义顺序。

为什么不直接用 TrimPrefix？

TrimPrefix 只返回字符串，无法区分“原本就没前缀”和“匹配后恰好剩下原文形态”。需要知道命中哪个候选时，CutPrefix 的布尔返回值更合适。

空前缀是不是可以放在最后？

即使放最后也会匹配所有输入，通常会掩盖配置错误。更稳妥的做法是加载配置时拒绝空值，或像示例一样显式过滤。