Go strings.Cut 如何判断前缀：布尔结果、空字符串与旧写法迁移

很多 Go 代码已经用 strings.HasPrefix 判断过前缀，但一旦还要拿掉前缀、保留剩余内容，旧写法往往会把判断、切片和边界处理拆成几行。strings.Cut 直接返回 before、after 和 found，能把“有没有分隔符”和“分隔后是什么”放在同一个结果里；不过它判断的是分隔符，不是专门的前缀 API，空字符串和未命中时的返回值要先弄清楚。

记住这一条：before, after, found := strings.Cut(s, sep)；未找到时 found=false、before=s、after=""。只判断前缀继续用 HasPrefix，既判断又取剩余部分时再用 Cut。

先看一个能直接运行的最小例子

假设配置项的值形如 region:cn-east。我们只想把第一个冒号左边当作键，右边作为值：

package main

import (
    "fmt"
    "strings"
)

func main() {
    before, after, found := strings.Cut("region:cn-east", ":")
    fmt.Printf("before=%q after=%q found=%v\n", before, after, found)
}

输出是 before="region" after="cn-east" found=true。这里的 found 比拿 after == "" 猜测是否命中更可靠，因为 region: 的分隔符确实存在，只是右侧值为空。

它和 HasPrefix 的职责并不一样

如果问题只是“这条输入是否以 Bearer 开头”，最清楚的写法仍是：

if strings.HasPrefix(header, "Bearer ") {
    token := strings.TrimPrefix(header, "Bearer ")
    useToken(token)
}

要是把它改成 strings.Cut(header, "Bearer ")，含义就变成“在整条字符串里找第一次出现的 Bearer ”。例如 "note=Bearer x" 也会命中，这不是前缀检查。前缀任务用 HasPrefix 加 TrimPrefix，分隔字段任务用 Cut，代码意图更不容易被误读。

三个边界值决定了迁移是否安全

未找到分隔符

before, after, found := strings.Cut("cn-east", ":")
// before == "cn-east"
// after == ""
// found == false

未找到时，原字符串完整保留在 before 中。不要只检查 before 是否为空，也不要把 after 为空直接当成失败。

右侧为空不等于未命中

before, after, found := strings.Cut("region:", ":")
// before == "region"
// after == ""
// found == true

这类输入是否允许，应由业务校验决定，例如配置解析器可以在 found 为真后再检查 after != ""。

分隔符为空字符串

空分隔符是特殊情况。它会在 UTF-8 字符边界产生切分结果，不适合拿来表示“没有配置分隔符”。如果分隔符来自配置，建议先拒绝空值，把错误留在入口处：

if sep == "" {
    return fmt.Errorf("separator must not be empty")
}
before, after, found := strings.Cut(input, sep)

从 Index 和切片迁移时，先对齐旧契约

常见旧写法是先找下标，再按下标切片：

i := strings.Index(input, ":")
if i 

迁移成 Cut 后，正常路径更短，但要确认旧代码是否处理了“只允许一个分隔符”“允许值为空”或“没有分隔符时返回原文”等约定。Cut 只切第一次出现的位置；如果要切最后一次，应看 strings.LastIndex 或重新定义解析规则。

用表驱动测试把结果锁住

func TestCutPair(t *testing.T) {
    tests := []struct {
        name, input, sep, before, after string
        found                           bool
    }{
        {"normal", "region:cn-east", ":", "region", "cn-east", true},
        {"missing", "cn-east", ":", "cn-east", "", false},
        {"empty-value", "region:", ":", "region", "", true},
    }
    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            before, after, found := strings.Cut(tt.input, tt.sep)
            if before != tt.before || after != tt.after || found != tt.found {
                t.Fatalf("got %q, %q, %v", before, after, found)
            }
        })
    }
}

验收重点不是测试数量，而是把未命中、右侧空值和普通输入分别写出来。这样后续有人把 found 删除、或把空值当成未命中时，测试会马上暴露问题。

常见问题

strings.Cut 能代替 HasPrefix 吗？

不能完全代替。Cut 查找任意位置的分隔符；只判断开头应使用 HasPrefix，需要去除前缀则配合 TrimPrefix。

未命中时为什么 after 是空字符串？

这是 API 的固定返回契约，是否命中由第三个返回值 found 表示。业务代码应先判断它，再决定是否接受空的右侧值。

什么时候应该用 SplitN？

当调用方确实需要切成最多两个字符串并希望直接得到切片时，可以考虑 SplitN；当需要明确区分“没找到分隔符”和“找到了但右侧为空”，Cut 的布尔结果更直观。

把选择规则留在调用点

判断前缀就用前缀 API，拆分键值就用 Cut，需要最后一个分隔符就明确选择对应的旧索引逻辑。真正值得迁移的不是少写几行，而是让输入契约、空值边界和失败分支在代码里一眼可见。