unique Make 与 Handle 如何管理可比较值的唯一实例

Go 的 unique 包适合把可比较值规范化为可以快速比较的 Handle[T]：把值交给 unique.Make，保留返回的 Handle，在后续对象之间直接用 == 判断；只有需要原值时才调用 Value()。这条链路解决的是“相同值共享规范身份和比较入口”，不是替代业务缓存，也不是让不可比较的切片、映射直接获得唯一实例。

官方文档：https://pkg.go.dev/unique

最小规则是：T 必须满足 comparable；Handle 要跟随需要使用它的对象存活；Handle 相等等价于创建它们的值相等；Value 返回的是 T 的浅拷贝。生命周期结束后，内部规范值才有机会被回收。

• 输入门槛：只能传入可比较类型，包含字段均可比较的结构体也可以。
• 核心结果：相等输入得到相等 Handle，比较 Handle 通常比反复比较长值更轻。
• 保留条件：不要只保存 Value() 后立刻丢掉 Handle，否则无法表达持续的保留关系。

先划定输入、身份与生命周期边界

Make[T comparable](value T) 的输入是值，不是指针身份。两个值只要按 Go 的相等规则相等，得到的两个 Handle 就相等；这使 Handle 可以作为对象中的轻量比较字段。字符串、整数、数组和字段均可比较的结构体适合这一模式；含切片、映射或函数字段的类型不满足约束。

Handle 的生命周期也是设计的一部分。Go 官方说明中，Handle 存在期间，内部映射会保留相应的规范值；当指向该值的 Handle 都不可达后，条目才有机会在后续回收中被清理。因此，长期对象应保存 Handle，而不是只保存一次 Value() 的结果。

把 Make 放进可重复执行的处理链

在自动化任务中，可以把每次输入看成一条可重试的处理记录：入口接收值，规范化层调用 Make，业务对象保存 Handle，比较门禁只比较 Handle，展示层按需调用 Value。重复执行同一值不会要求调用方维护一张手写全局 map，也不会改变 Handle 的相等语义。

package main

import (
    "fmt"
    "unique"
)

type RouteKey struct {
    Method string
    Path   string
}

type Job struct {
    // 保存 Handle，让任务在存活期间维持规范值的使用关系。
    Key unique.Handle[RouteKey]
}

func newJob(method, path string) Job {
    // RouteKey 的字段都可比较，因此可以交给 Make 做规范化。
    return Job{Key: unique.Make(RouteKey{Method: method, Path: path})}
}

func sameRoute(a, b Job) bool {
    // 相等判断只比较 Handle，不重新比较 RouteKey 的每个字段。
    return a.Key == b.Key
}

func main() {
    left := newJob("GET", "/health")
    right := newJob("GET", "/health")
    fmt.Println(sameRoute(left, right))
    // 只有需要展示或记录时才取回值；Value 返回浅拷贝。
    fmt.Printf("%s %s\n", left.Key.Value().Method, left.Key.Value().Path)
}

这里的“门禁”只是代码层面的判断：sameRoute 不负责权限、不负责缓存失效，也不应把 Handle 当作跨进程协议值。若结构体含有指针字段，仍要确认你真正想要的是指针相等语义；规范化不会替你改变 Go 的 == 规则。

比较、取值和回收各自负责什么

并发场景可以让多个 goroutine 调用 Make 和 Value，但这不等于你的外层对象自动线程安全；对可变外层状态仍需自己的同步。若任务只是短期去重且不需要稳定的 Handle 字段，普通 map 或排序去重可能更直观；若需要跨进程持久化，应保存明确的业务键，而不是保存 Handle。

上线前的采用清单与常见问题

先确认类型约束，再决定 Handle 放在哪里；接着确认对象销毁后是否允许规范值回收；最后检查日志、序列化和跨进程边界是否误把 Handle 当成业务 ID。文章标题中的“唯一”指同值对应的规范身份，不代表全局永不变化的字符串地址或永不回收的缓存条目。

unique.Handle 可以替代 map 做业务缓存吗？

不能直接替代。它提供的是值的规范化和比较入口，不提供按业务策略淘汰、过期、容量上限或持久化协议。

为什么 Make 后还要保存 Handle？

Handle 是内部规范值的使用关系。只留下 Value，不能表达某个规范值仍被业务对象使用。

Value() 是深拷贝吗？

不是。官方定义是浅拷贝；如果 T 内部含有引用型字段，仍要按这些字段自身的共享规则设计。