Go x/text/cases Fold 怎样生成不区分大小写的匹配文本

如果接口需要把用户输入归并成“不区分大小写”的匹配键，可以用 golang.org/x/text/cases 的 Fold：先创建一个大小写折叠器，再对双方调用 String，最后比较折叠后的字符串。它针对 Unicode case folding，而不是简单地把每个 ASCII 字母转成小写。

官方地址：https://pkg.go.dev/golang.org/x/text/cases

最小写法是 fold := cases.Fold() 和 fold.String(input)。Fold 返回的转换器是无状态的，可以并发复用；但它不会做 Unicode 规范化，也不适合代替语言学排序或安全标识符比较。

先把大小写差异变成同一个比较键

在登录名、命令别名、配置键或本地缓存索引中，直接比较原字符串会把 Go、go 和 GO 当成不同值。先生成折叠键，再比较键本身，代码更容易复用：

package main

import (
    "fmt"

    "golang.org/x/text/cases"
)

func main() {
    fold := cases.Fold()

    left := fold.String("Go 编程")
    right := fold.String("go 编程")

    // 折叠只负责大小写等价；真正的业务判断仍然是字符串比较。
    fmt.Println(left == right)
    fmt.Println(left)
    fmt.Println(right)
}

这个写法的关键不是把结果保存成“全小写文本”，而是把它当作比较键。展示给用户时仍然保留原始输入；只有查找、去重或索引时使用折叠后的值。

字符串和字节切片分别怎么处理

cases.Caser 同时提供 String 和 Bytes。输入本来是字符串时使用 String 最直接；输入来自协议缓冲区或文件缓冲区时，可以直接对字节切片转换，避免为了比较先写一层无意义的包装。

package main

import (
    "fmt"

    "golang.org/x/text/cases"
)

func main() {
    fold := cases.Fold()
    raw := []byte("HTTP-Header")

    // Bytes 返回新的字节切片；不要把返回值当作原切片的原地修改结果。
    folded := fold.Bytes(raw)
    fmt.Printf("%s == %s: %t\n", raw, folded, string(folded) == "http-header")
}

如果代码要持续处理流式数据，还可以使用 Transform 或 Span，但它们属于 transform.Transformer 这一层 API，需要自己处理目标缓冲区、源缓冲区和 atEOF。只是做键生成时，String 或 Bytes 更不容易把缓冲区生命周期搞错。

不要把 Fold 当成 Unicode 规范化

这是最容易写错的地方。官方文档明确说明，case folding 不会规范化输入，结果也可能不保持某种规范形式。因此，下面两个问题要分开：

也就是说，Fold 适合“同一类大小写写法应命中同一个键”，不负责去掉重音、兼容字符归一化、语言排序或安全策略。若业务同时要求这些能力，应在选型时明确增加对应的处理层。

并发复用时只记住一个区别

Fold 返回的 Caser 是无状态的，可以被多个 goroutine 并发使用。这样可以在服务初始化时创建一次，后续请求共享同一个折叠器：

package main

import (
    "fmt"
    "sync"

    "golang.org/x/text/cases"
)

var fold = cases.Fold()

func main() {
    inputs := []string{"Go", "GO", "go"}
    var wg sync.WaitGroup
    for _, input := range inputs {
        input := input
        wg.Add(1)
        go func() {
            defer wg.Done()
            // Fold 返回的 Caser 无状态，适合被并发请求共享。
            fmt.Println(fold.String(input))
        }()
    }
    wg.Wait()
}

这里的“可以并发复用”是 Fold 的特性，不要顺手推广到所有 cases.Caser。官方文档提醒，Caser 可能有状态；如果改用需要维护转换上下文的其他转换器，应按其文档决定是否每次创建、串行复用或调用 Reset。

一份可直接套用的选择清单

1. 先确认需求是“大小写不同也视为相同”，是的话优先创建一个 cases.Fold()。
2. 把 fold.String 的结果作为索引键，不要覆盖用户原始文本。
3. 字节输入直接考虑 fold.Bytes；流式转换再进入 Transform 层。
4. 需要规范化、语言排序或查找时，换用 collate、search 或相应的安全包。
5. 服务端共享时可复用 Fold 返回值；不要默认所有 Caser 都满足相同的并发条件。

常见追问

Fold 和 strings.ToLower 有什么区别？

strings.ToLower 表达的是转成小写，Fold 表达的是 Unicode case folding。做跨语言的不区分大小写匹配时，后者的语义更贴近“大小写等价”，但它仍然不负责规范化。

Fold 的结果能直接展示给用户吗？

不建议。折叠结果应该作为内部比较键；界面、日志和回显应优先保留用户输入或业务规定的展示文本。

Fold 能解决重音符号不同导致的匹配失败吗？

不能把它当作这类保证。大小写折叠和规范化、重音处理是不同问题，若业务需要宽松匹配，应单独定义并选择对应的文本处理策略。

归纳起来，cases.Fold() 最适合做 Unicode 不区分大小写的内部比较键：创建一次、按需调用 String 或 Bytes，并把“规范化、语言学比较、安全比较”留给更匹配的组件。