Go 怎样安全移除可选前缀

处理请求路径、协议标识或配置值时，经常会遇到“前缀可能有，也可能没有”的字符串。Go 里推荐用 strings.CutPrefix：它只检查字符串开头是否完整匹配，返回去掉前缀后的内容以及一个 found 布尔值。这样既不会误删中间文本，也不会把“没有匹配”和“匹配后结果为空”混成一类。

先看清楚：要删的是开头，不是所有相似文本

“移除前缀”通常意味着只有字符串从第一个字节开始完整匹配时才执行删除。例如 Bearer token 的前缀是 Bearer ，但 token-Bearer 不应被处理。也不要用 strings.Trim 代替：Trim 面向的是字符集合，会连续移除两端属于集合的字符，规则比“完整前缀”宽得多。

官方 strings 包把 CutPrefix 定义为返回去掉给定前缀后的字符串和是否找到前缀的标志；该函数从 Go 1.20 开始可用。写代码前先决定未命中时是保留原值、返回错误，还是跳过这条记录，这个业务选择比切片语法更重要。

最小写法：用两个返回值保留判断依据

直接把函数结果拆成两个变量即可。下面的例子把协议前缀当作可选信息：命中时使用剩余内容，未命中时保留原始输入，并用中文注释标出业务分支。

package main

import (
    "fmt"
    "strings"
)

func main() {
    raw := "Bearer abc123"

    // CutPrefix 只匹配开头的完整前缀，不会搜索中间文本。
    token, found := strings.CutPrefix(raw, "Bearer ")
    if !found {
        // 未命中时保留原值，实际项目也可以在这里返回错误。
        token = raw
    }

    // found 用来区分“没有前缀”和“去掉前缀后恰好为空”。
    fmt.Printf("token=%q, found=%t\n", token, found)
}

这里不能只写成 token := strings.TrimPrefix(raw, "Bearer ") 然后猜测结果。TrimPrefix 在未命中时也会返回原字符串，但没有额外的命中标志；如果业务要记录输入格式异常、统计兼容请求或决定是否拒绝，就应该保留 found。

排查两个容易混淆的边界

第一，未命中和结果为空不是一回事。strings.CutPrefix("abc", "x") 返回 "abc", false；而 strings.CutPrefix("abc", "abc") 返回 "", true。第二，空前缀会被视为已经匹配，返回原字符串和 true。如果前缀来自配置，通常应在进入处理函数前决定空值是否允许。

package main

import (
    "fmt"
    "strings"
)

func removeOptionalPrefix(input, prefix string) (string, bool, error) {
    // 空前缀是否有效取决于业务；这里选择显式拒绝，避免配置错误被静默放过。
    if prefix == "" {
        return input, false, fmt.Errorf("prefix must not be empty")
    }

    // 保留 found，让调用方可以区分格式不符合预期与正常空结果。
    result, found := strings.CutPrefix(input, prefix)
    return result, found, nil
}

这个封装没有把“未命中”强行变成错误，因为有些输入格式确实允许省略前缀。调用方可以根据 found 选择记录日志、使用默认分支或返回业务错误；如果前缀等于全文，result 为空仍然是一次成功匹配。

兼容旧版本时怎样写，怎样避免越界

项目尚未使用 Go 1.20 时，可以先判断 strings.HasPrefix，再按前缀的字节长度切片。判断必须先发生，因为直接写 input[len(prefix):] 在前缀比输入更长时会越界。Go 字符串切片按字节索引，而这里的 HasPrefix 与切片边界使用的是同一段前缀字节，因此不需要把中文前缀转换成 rune 才能安全切分。

package main

import "strings"

func cutPrefixCompat(input, prefix string) (string, bool) {
    // 先确认前缀存在，再切片，避免 prefix 比 input 长导致越界。
    if !strings.HasPrefix(input, prefix) {
        return input, false
    }

    // len 返回字节数，正好对应 Go 字符串切片的索引单位。
    return input[len(prefix):], true
}

新代码优先使用 CutPrefix，因为它把判断和截取组合成了一个表达意图更清晰的 API。只有在版本兼容要求明确时才保留兼容写法，并用单元测试覆盖“未命中、完整命中、前缀等于全文、非 ASCII 前缀”这几类输入。

常见问题

CutPrefix 会删除字符串中间出现的前缀吗？

不会。它只检查开头的完整匹配；中间或结尾的相同文本不会被改动。

前缀不存在时应该返回错误吗？

由业务决定。格式要求严格的接口可以把 found=false 转成错误，可选格式则保留原值继续处理。

CutPrefix 和 TrimPrefix 怎样选？

只需要结果时可以用 TrimPrefix；需要知道是否命中时优先用 CutPrefix，它能避免把未命中误判为合法空结果。