Go x/text/cases Caser 为什么不能在并发任务中随意共享

我在把多语言标题格式化放进并发任务时，最容易忽略的不是大小写规则，而是转换器的所有权。golang.org/x/text/cases 文档明确提醒：Caser 可能有状态，因此不应该在 goroutine 之间直接共享。

官方文档：https://pkg.go.dev/golang.org/x/text/cases

结论很简单：Lower、Upper、Title 返回的 Caser 按“一个并发任务一个实例”组织；如果确实要跨 goroutine 共享，只考虑文档明确说明无状态且可并发使用的 Fold 返回值。String 和 Bytes 适合一次性转换，Transform 则应把实例生命周期收紧在单个任务内。

为什么 Caser 不能随意共享

Caser 实现了 transform.Transformer。这类接口既可以处理完整字符串，也可以分段处理字节流。文档对 Caser 的描述是“可能有状态”，所以它的值类型并不等于“可以安全并发访问”。并发问题往往不是每次都复现，而是两个任务交错使用内部转换上下文时，出现结果互相影响或状态被错误复用。

这也是为什么把一个包级变量写成 var titleCaser = cases.Title(...)，再让所有 worker 直接调用，并不是稳妥的默认方案。真正可以共享的不是“看起来只读的配置”，而是 API 明确承诺无状态的对象。

并发任务怎样创建自己的 Lower、Upper 或 Title

如果任务做的是语言相关的转小写、转大写或标题式大小写，推荐让 worker 自己持有 Caser。实例可以在 worker 启动时创建，也可以由任务函数接收，但不要在多个 goroutine 之间循环传递同一个实例。

package main

import (
    "fmt"
    "golang.org/x/text/cases"
    "golang.org/x/text/language"
)

func formatTitle(text string) string {
    // 每次调用都建立任务私有的 Title Caser，避免并发任务共享可变转换状态。
    caser := cases.Title(language.English)
    return caser.String(text)
}

func main() {
    // 真实服务中可把这类函数交给多个 worker，各自拥有自己的 Caser。
    fmt.Println(formatTitle("hello from a worker"))
}

这种写法的重点不是“每个字符串都必须新建对象”，而是建立清晰的所有权边界。若一个 worker 会处理很多输入，可以在 worker 内创建一次并串行复用；若要让一个实例同时服务多个 goroutine，就已经超出了这个安全边界。

String、Bytes 和 Transform 怎么选

完整字符串优先用 String，完整字节切片优先用 Bytes。它们表达的是一次转换，调用者不需要管理分段输入的中间状态。Bytes 返回新的字节切片，调用方仍应按自己的数据生命周期保存结果。

func normalizeLabel(input []byte) []byte {
    // Upper 的 Caser 只在当前调用链中使用，返回值是新的转换结果。
    caser := cases.Upper(language.English)
    return caser.Bytes(input)
}

只有在接入流式读取或写入接口时，才需要直接使用 Transform。这时 Caser 的状态会跨越多次调用，应该像读写缓冲区一样由一个任务独占；任务结束后不要把它放回全局变量供其他 goroutine 继续使用。

func convertChunked(caser cases.Caser, chunks [][]byte) (string, error) {
    var out []byte
    for _, chunk := range chunks {
        // 该示例把 Caser 限制在当前任务；真实流式代码还要按 dst 空间处理 nDst、nSrc。
        dst := make([]byte, len(chunk)*4+16)
        nDst, nSrc, err := caser.Transform(dst, chunk, false)
        if err != nil {
            // 转换错误必须由当前任务处理，不能把半成品状态交给下一个调用者。
            return "", err
        }
        if nSrc != len(chunk) {
            // 输入未完整消费时，调用方应保留未消费字节并继续喂给同一个任务实例。
            return "", fmt.Errorf("未完整消费输入：%d/%d", nSrc, len(chunk))
        }
        out = append(out, dst[:nDst]...)
    }
    // 当前任务不再使用 caser；若后续复用，必须由同一所有者决定何时 Reset。
    return string(out), nil
}

上面的示例只强调所有权和错误分支，生产代码还要根据缓冲区大小处理 transform.ErrShortDst、transform.ErrShortSrc 以及最后一次 atEOF=true 的调用。不要因为一次调用返回了字符串，就推断分段转换器也一定没有状态。

需要共享时为什么是 Fold，而不是随意共享 Caser

文档对 Fold 有单独承诺：它返回的 Caser 是无状态的，可以被多个 goroutine 并发使用。但 case folding 是比较语义，不等于面向用户展示的语言特定小写、标题式大小写；它也不会替你做 Unicode 规范化。

var folded = cases.Fold()

func equalKey(a, b string) bool {
    // Fold 返回的 Caser 无状态，适合在只读场景中被多个调用方共享。
    return folded.String(a) == folded.String(b)
}

共享 Fold 也不表示所有比较需求都能解决。官方文档建议根据语言学排序或安全比较需求考虑 collate、search 或 secure/precis。如果你的目标是展示标题、处理土耳其语等语言规则，仍应为每个并发任务创建对应语言的 Lower、Upper 或 Title。

排查并发实现时的四个问题

1. 共享的是哪一种 Caser？ 如果来自 Lower、Upper 或 Title，默认按不可跨 goroutine 共享处理；只有 Fold 有明确的无状态承诺。
2. 是否跨调用使用了 Transform？ 只要输入可能分段，实例就可能携带上下文。把它和输入缓冲、输出缓冲放在同一个任务对象里。
3. Reset 由谁调用？ Reset 是给上一次 Transform 后准备复用的实例使用的，不能让一个 goroutine 重置另一个 goroutine 正在使用的 Caser。
4. 目标是显示还是比较？ 显示文本使用语言相关 Caser；键比较才考虑 Fold，并确认不需要规范化、排序或安全标识符语义。

常见问题

把 Caser 放进 sync.Pool 就能并发复用吗？

不能。池只能管理“当前没有使用者”的对象，不能把仍在某个 goroutine 中工作的 Caser 放回池。取出后必须由一个任务独占，归还前要完成输入消费与必要的 Reset。

只调用 String，还需要担心共享吗？

仍应遵守文档的并发限制。String 是更简单的一次性接口，但它调用的接收者仍然是可能有状态的 Caser；不要把接口方便误认为并发安全承诺。

Fold 能替代 Title 吗？

不能。Fold 用于 Unicode case folding，更适合大小写不敏感的比较键；Title 是语言相关的标题式大小写，两者的结果和使用目的不同。

最后可以把规则记成一句话：语言格式化器由任务拥有，比较折叠器才按文档承诺共享；一旦进入 Transform，就把 Caser、缓冲区和完成点放在同一个生命周期里。