Go strings.CutPrefix 前缀不存在时如何保留原字符串

如果协议前缀是可选的，`strings.CutPrefix` 的正确用法是同时接收两个返回值：前缀存在时使用去掉前缀后的字符串；前缀不存在时直接保留原字符串，并根据 `found` 判断是否真的匹配。它不会因为匹配失败返回空串，也不会修改原字符串。

先看懂 CutPrefix 的两个返回值

函数签名是 `func CutPrefix(s, prefix string) (after string, found bool)`。它只检查字符串开头是否完整等于 `prefix`：匹配时，`after` 是剩余部分；不匹配时，`after` 仍是原来的 `s`。因此不要只接收第一个返回值，否则“没有前缀”和“去掉前缀后恰好为空”会混在一起。

package main\n\nimport (\n    "fmt"\n    "strings"\n)\n\nfunc main() {\n    samples := []string{"https://api.example.com/users", "api.example.com/users"}\n    for _, raw := range samples {\n        // found 记录是否真的剥离了协议前缀，避免把普通主机名误判为 HTTPS 地址。\n        rest, found := strings.CutPrefix(raw, "https://")\n        fmt.Printf("原值=%q，剩余=%q，匹配=%t\\n", raw, rest, found)\n    }\n}

第一行会得到 `api.example.com/users` 和 `true`；第二行得到原值和 `false`。这正是“有就去掉，没有就保留”的语义。

用 found 区分可选前缀与普通文本

在请求地址、消息头或文件名处理中，后续逻辑往往不仅关心剩余文本，还要知道输入是否带过某个标记。例如去除 `Bearer ` 后再交给令牌解析器时，只有 `found` 为 `true` 才能确认输入走过了这条协议分支。

func stripScheme(raw string) (string, string) {\n    // 依次处理明确允许的协议；不匹配时保留 raw，调用方仍能识别 unknown。\n    if rest, ok := strings.CutPrefix(raw, "https://"); ok {\n        return "https", rest\n    }\n    if rest, ok := strings.CutPrefix(raw, "http://"); ok {\n        return "http", rest\n    }\n    return "unknown", raw\n}

这里不建议写成“先 CutPrefix，再依据剩余字符串猜协议”。因为地址可能本来就没有协议，猜测会把输入分类错误。返回值中的布尔量就是明确的证据。

空前缀、重复前缀和大小写要单独处理

空前缀是一个容易被忽略的边界：`strings.CutPrefix("abc", "")` 返回 `"abc", true`。这是因为空字符串出现在任何字符串的开头。若前缀来自可选配置，生产代码通常应先拒绝空配置，否则所有输入都会被当成“匹配成功”。

它只删除一次，并且大小写敏感。输入 `https://https://host` 只会去掉最左侧的一段；输入 `HTTPS://host` 不会匹配小写的 `https://`。如果业务真的允许大小写不敏感，应先明确规范化策略，再做协议判断，不能把这个函数当作大小写折叠工具。

旧版本 Go 如何保留相同语义

`CutPrefix` 是 Go 1.20 加入的 API。如果项目仍需支持更早版本，可以显式先判断前缀，再切片。关键是失败分支返回原字符串，而不是返回空串。

func cutPrefixCompat(s, prefix string) (string, bool) {\n    // 先做字节前缀判断；HasPrefix 与字符串切片在这里保持 CutPrefix 的契约。\n    if !strings.HasPrefix(s, prefix) {\n        return s, false\n    }\n    return s[len(prefix):], true\n}

切片边界使用 `len(prefix)`，因为 Go 的字符串下标按字节计算，而 `HasPrefix` 也按完整字节序列判断。不要先把字符串转成 `[]rune` 再用字节长度切片；那会让索引单位不一致。

常见问题

CutPrefix 失败时会返回空字符串吗？

不会。失败时返回原字符串和 `false`，空字符串只可能是原字符串本身为空，或匹配成功后剩余部分为空。

能用 CutPrefix 去除所有重复前缀吗？

不能。它只处理开头的一次匹配；需要循环时应先定义最大次数和异常输入策略。

CutPrefix 会自动忽略大小写吗？

不会。它是大小写敏感的字节前缀匹配，大小写不敏感需求应单独规范化。

资料参考：Go 标准库 `strings` 包文档中对 `CutPrefix` 的签名、Go 1.20 引入信息及失败返回语义。