Go unique.Handle 如何判断值身份：可比性限制与释放后访问边界

做标签去重时，很多代码先把字符串放进 map，再到处传原值。Go 的 unique 包提供了另一种表达：用 unique.Make 把可比较值变成可比较的 unique.Handle，之后比较句柄，不必反复比较原值。关键边界也很明确：类型必须满足 comparable，Handle.Value 取回的是浅拷贝，而且句柄的身份只在当前进程生命周期内有意义。

同一个值通过 unique.Make 得到的句柄相等；需要跨进程、落库或长期传输时，仍应保存原值或业务 ID，不能把 unique.Handle 当成稳定主键。

先用一个标签池看懂 unique.Handle

下面的小实验把日志标签规范化成句柄。两个输入字符串相同，得到的 h1 和 h2 可以直接比较；不同字符串则产生不同身份。这里的“全局唯一”是相对于当前 Go 进程里的规范化表而言，不是可写入数据库的随机 ID。

package main

import (
    "fmt"
    "unique"
)

func main() {
    h1 := unique.Make("warning")
    h2 := unique.Make("warning")
    h3 := unique.Make("info")

    fmt.Println(h1 == h2) // true
    fmt.Println(h1 == h3) // false
    fmt.Println(h1.Value()) // warning
}

这里真正值得记住的是三个节点：unique.Make 负责把值送进规范化过程，unique.Handle 是返回的可比较身份，h1 == h2 是后续的廉价判断。不要把它理解为“把字符串内容永久换成一个可跨服务传输的编号”。

comparable 决定了哪些值可以建立句柄

unique.Make[T comparable] 的类型约束会在编译期挡住不可比较的类型。字符串、整数、指针以及只包含可比较字段的结构体可以使用；切片、映射和函数不能直接使用，因为它们不能用 == 做值比较。

type Label struct {
    Name  string
    Level int
}

func labelHandle() unique.Handle[Label] {
    return unique.Make(Label{Name: "warning", Level: 2})
}

// 下面的写法不能通过编译：[]string 不满足 comparable。
// _ = unique.Make([]string{"warning", "info"})

如果业务输入本来是切片，先明确你要比较的是“顺序敏感的内容”还是“无序集合”。前者可以按稳定规则拼成字符串，后者应排序后再编码，不能直接把原切片塞给 unique.Make。这一步是业务语义转换，不是 unique 包替你完成的。

Handle.Value 取回的是浅拷贝，不是新的生命周期

Handle.Value 会返回创建句柄时的 T 值浅拷贝。这里的 T 仍受 comparable 约束；对字符串和整数来说，这个边界很直观，对包含指针的可比较结构体，外层结构体是复制的，但指针指向的对象仍然是同一个对象。句柄也没有释放、导出或跨进程恢复接口。

type UserKey struct {
    Tenant string
    UserID int64
}

h := unique.Make(UserKey{Tenant: "acme", UserID: 42})
got := h.Value()
fmt.Println(got == UserKey{Tenant: "acme", UserID: 42}) // true

这个结果说明 Value 适合在当前进程内恢复原值做日志或分支判断，但不适合把句柄序列化后期待下一次启动还能得到同一身份。进程结束，规范化表的生命周期也随之结束。

并发和持久化场景应该怎么选

unique.Make 可以被多个 goroutine 并发调用，因此适合在进程内把重复标签、重复配置值或重复的枚举文本规范化。它解决的是“当前进程里两个值是否代表同一份规范化身份”，不是缓存淘汰、分布式去重或数据库主键生成。

• 只在内存中比较标签身份：使用 unique.Handle，并把原值留在需要展示的位置。
• 需要写入消息、数据库或跨服务：传输字符串、整数或业务 ID，不传句柄的内部状态。
• 需要比较切片内容：先定义稳定的编码规则，再对编码后的可比较值调用 unique.Make。

一个实用验收方法是同时重启程序并检查持久化记录：如果业务仍要求“重启后相同”，验收对象必须是原值或业务 ID，而不是句柄相等性。

常见问题

unique.Handle 可以当数据库主键吗？

不建议。它是当前进程内的值身份，数据库主键需要稳定、可传输、可迁移的业务 ID。

两个不同的字符串会得到相同 Handle 吗？

不会。句柄相等当且仅当创建它们的值相等；代码仍应比较句柄，而不是猜测内部表示。

Handle.Value 会深拷贝结构体里的指针对象吗？

不会。文档定义它返回 T 的浅拷贝；如果 T 含指针，指向对象的共享关系仍然存在。

验收清单

看到 unique.Make 时先确认 T 满足 comparable；看到 h1 == h2 时确认两个句柄来自同值；看到 Handle.Value 时确认调用方只把它当作当前进程内的浅拷贝。只要涉及重启、落库或跨服务，就切回原值或业务 ID。