Go strings.CutPrefix 的未匹配结果保留方式

处理固定前缀时，strings.CutPrefix 的关键不是只拿到“处理后的字符串”，而是同时判断第二个返回值 found。前缀匹配，after 才会去掉一个前缀；前缀未匹配，after 会保留原字符串，found 为 false。这样调用方可以安全地区分“已剥离”和“原样传递”。

官方文档：https://pkg.go.dev/strings#CutPrefix

用两个返回值判断 CutPrefix 是否真正剥离

Go 标准库把函数签名定义为 strings.CutPrefix(s, prefix string) (after string, found bool)。它只检查 s 是否以给定的 prefix 开始，并且最多移除一个前缀。未找到时，返回的 after 仍是原字符串；因此只比较字符串内容，无法表达“这次没有匹配”。

package main

import "strings"

func removeProtocolPrefix(raw string) (string, bool) {
	// after 保存剥离结果，found 表示是否真的匹配了前缀。
	after, found := strings.CutPrefix(raw, "proto://")
	// 未匹配时保留原值，让上层决定是否接受这类输入。
	if !found {
		return raw, false
	}
	return after, true
}

例如输入 proto://node-7 时，结果是 node-7 和 true；输入 node-7 时，结果是原值和 false。这里显式返回 raw 是为了让“原样传递”的意图留在业务代码中，而不是依赖读者记住实现细节。

在未匹配分支保留原始字符串

如果这个函数用于解析文件名、路由片段或协议字段，未匹配通常不是“把字符串改成空值”，而是“当前规则不适用”。建议把状态判断放在剥离动作附近，避免先使用 after，稍后才猜测它是否发生过变化。

不要用 after != raw 代替 found。在空前缀等边界下，匹配状态和字符串是否变化是两个不同概念；业务分支应该读取 found。

把空前缀、大小写和 UTF-8 边界写清楚

空字符串前缀是一个容易忽略的边界：任何字符串都以空字符串开头，因此 found 为 true，after 仍等于原输入。如果前缀来自配置，通常应先在配置层禁止空值，或者明确它代表“无需剥离”。

CutPrefix 不做大小写折叠，也不做 Unicode 规范化。API- 和 api- 是不同前缀；看起来相同的组合字符与预组合字符，也不能默认视为同一字节序列。需要不区分大小写或规范化时，应在更上游定义输入规则，不要把这些额外语义塞进本函数。

用测试表覆盖结果判断

测试重点应放在四个值：输入字符串、前缀、期望的 after 和期望的 found。至少覆盖带前缀、未带前缀、空前缀、空输入和大小写不同；这样以后修改调用方时，不会把“未匹配保留原值”误改成“清空字段”。

func TestCutPrefixContract(t *testing.T) {
	cases := []struct {
		name, input, prefix, want string
		found bool
	}{
		{"matched", "proto://a", "proto://", "a", true},
		{"not matched", "a", "proto://", "a", false},
		{"empty prefix", "a", "", "a", true},
	}
	for _, tc := range cases {
		// 表驱动用例把数据结果和匹配状态一起固定下来。
		after, found := strings.CutPrefix(tc.input, tc.prefix)
		if after != tc.want || found != tc.found {
			t.Fatalf("%s: after=%q found=%v", tc.name, after, found)
		}
	}
}

常见问题

未匹配时 after 一定是空字符串吗？

不是。未匹配时 after 保留原输入，真正表示未匹配的是 found == false。

CutPrefix 会移除多个连续前缀吗？

不会。它只处理开头的一个指定前缀；需要重复剥离时，应在业务层明确循环条件和上限。

能用 CutPrefix 做不区分大小写的判断吗？

不能直接做到。它执行精确前缀判断，大小写折叠应由调用方先定义清楚。