Go strings.Cut 如何区分分隔符不存在和空字段

处理 key=value、HTTP 头部或命令行参数时，最容易写错的地方是把“没有分隔符”和“分隔符两边有空字段”混成一件事。strings.Cut 的正确判断方式是看第三个返回值 found：它为 false 才表示分隔符根本不存在；只要分隔符出现，即使 before 或 after 是空字符串，found 仍然是 true。

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

先看 strings.Cut 的三个返回值

函数签名是 func Cut(s, sep string) (before, after string, found bool)。它只围绕 s 中第一次出现的 sep 切一刀，并且不把分隔符放进左右结果。判断协议很简单：

因此，空字符串只是字段内容的一种结果，不是“没切到”的证据。缺失分隔符时，Cut 会把原字符串放到 before，把 after 置空，同时返回 false。

用 found 区分缺失、前置空字段和尾部空字段

下面的示例专门覆盖边界输入。代码注释说明了判断重点；输出块只展示预期的打印格式，不代表本机运行截图。

package main

import (
	"fmt"
	"strings"
)

func showCut(s, sep string) {
	// found 判断分隔符是否出现，不能用 before 或 after 是否为空替代。
	before, after, found := strings.Cut(s, sep)
	fmt.Printf("%q => before=%q after=%q found=%v\n", s, before, after, found)
}

func main() {
	showCut("=go", "=")      // 左字段为空，但分隔符存在
	showCut("name=", "=")   // 右字段为空，但分隔符存在
	showCut("=", "=")       // 两侧字段都为空，但分隔符存在
	showCut("name", "=")    // 分隔符缺失，才是 found=false
}

"=go" => before="" after="go" found=true
"name=" => before="name" after="" found=true
"=" => before="" after="" found=true
"name" => before="name" after="" found=false

如果业务允许空键或空值，应先保留 found 的判断结果，再决定是否对字段做校验。例如配置解析通常可以分成三种状态：缺少等号是格式错误；有等号但键为空是键校验错误；有等号且键非空、值为空则可能代表“显式清空”。这三种状态的后续处理不同。

把判断封装成可复用的解析函数

在真实项目里，不要让调用方重复猜测返回值。可以封装一个解析函数，明确返回键、值和是否存在分隔符：

// splitPair 只负责切分；空键或空值是否允许由上层策略决定。
func splitPair(line string) (key, value string, ok bool) {
	key, value, ok = strings.Cut(line, "=")
	if !ok {
		// 没有等号时保留 ok=false，调用方可以报告格式问题。
		return "", "", false
	}
	return key, value, true
}

调用方随后再做业务校验：

key, value, ok := splitPair(line)
if !ok {
	return fmt.Errorf("缺少 = 分隔符")
}
if key == "" {
	return fmt.Errorf("键不能为空")
}
// value 为空仍是合法的“显式空值”，是否拒绝由业务规则决定。
use(key, value)

这种分层能把字符串切分和字段策略分开：strings.Cut 只回答“切没切到”，业务代码再回答“空字段能不能接受”。

常见问题：空分隔符、多个分隔符和兼容版本

多个等号时 strings.Cut 会怎么处理？

它只按第一次出现的分隔符切分。例如 "a=b=c" 得到 "a" 和 "b=c"。如果要拆出全部字段，应改用 strings.Split，不要在 Cut 后手动猜剩余格式。

sep 传空字符串时还能用 found 判断吗？

空分隔符属于特殊输入，结果遵循 strings 包对空字符串的处理规则。若业务协议要求非空分隔符，建议在调用 Cut 前主动拒绝，避免把特殊边界带进正常解析路径。

strings.Cut 从哪个 Go 版本开始提供？

官方文档标注它从 Go 1.18 加入。需要兼容更早版本时，可用 strings.Index 判断位置并切片，但仍要把“索引不存在”和“切片结果为空”分开表达。