Go 官方 uuid 库不支持 UUID v7，推荐使用 github.com/tidwall/uuid；它完整实现 RFC 9562，支持 NewV7()、Version() == 7 校验，字符串第13位为7，且兼容标准 UUID 格式。
Go 里直接用 github.com/google/uuid 不行，它不支持 UUID v7
截至 Go 1.22 和 github.com/google/uuid v1.6.x，该库只支持 UUID v1–v5 和 v18（nil/invalid），没有 UUID v7 实现。RFC 9562 定义的 UUID v7 是基于时间戳 + 随机/序列化后缀的紧凑有序 ID，目标是替代 v1/v4 在分布式系统中的部分场景。想用 v7，得换库或自己实现。
推荐用 github.com/segmentio/ksuid 或 github.com/oklog/ulid 替代？不，它们不是 UUID v7
ksuid 和 ulid 虽然也带时间戳、全局唯一、字典序可排序，但它们不是 UUID v7：结构不同（ULID 是 128-bit 但编码为 26 字符 base32；KSUID 是 160-bit）、版本号不匹配、二进制布局不符合 RFC 9562。如果你的下游系统（如 PostgreSQL 的 UUID 类型、OpenAPI schema 中的 format: uuid）明确要求“UUID v7”，它们会校验失败或被拒绝解析。
- PostgreSQL
SELECT '018e...-...-...-...-...'::UUID会接受 v7 字符串，但会拒绝 ULID/KSUID 字符串 - gRPC/JSON Schema 校验器可能按 RFC 4122 + 9562 检查 version 字段（v7 要求第 13 个 hex 字符是
7） - Go 的
uuid.Parse()会成功解析 v7 字符串，但u.Version()返回 0（因底层未识别）——这是兼容性陷阱
目前最稳妥的 Go 实现是 github.com/tidwall/uuid
这个库由 tidwall 维护，从 v1.0.0 起完整支持 UUID v7（以及 v6、v8）。它遵循 RFC 9562，生成的字节布局、版本位、变体位、时间戳编码方式全部正确，且兼容标准 UUID 字符串格式。
实操建议：
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 安装：
go get github.com/tidwall/uuid - 生成 v7：
id := uuid.Must(uuid.NewV7())（panic on error）或id, err := uuid.NewV7() - 验证版本：
id.Version() == 7返回 true；id.String()输出形如"0190...-...-...-...-..."，第 13 位是7 - 注意时钟回拨：
NewV7()使用time.Now().UnixMilli()，若系统时间跳变（如 NTP 校正），可能产生重复前缀——生产环境建议搭配单调时钟或逻辑序列号补偿（该库暂不内置）
自定义 v7 生成器要注意时间戳精度和序列位填充
如果必须手写（例如审计要求、嵌入式限制），核心是：128-bit 分 4 段——48-bit Unix milliseconds（高位对齐）、4-bit version（固定为 0b0111）、2-bit variant（固定为 0b10）、其余 70-bit 作随机/计数器。常见错误包括：
- 误用
time.Now().Unix()（秒级）→ 导致大量碰撞，必须用毫秒：time.Now().UnixMilli() - 把 version 位塞错位置（应在 byte[6] 的高 4-bit，即
(ts &^ 0xF000) | 0x7000） - 忽略 variant 位（byte[8] 高 2-bit 必须是
0b10，否则解析器认为非法） - 随机后缀用
math/rand（非加密、无 seed 控制）→ 改用crypto/rand.Read()或带节点 ID 的计数器
简单示例（仅示意结构，不推荐直接用于生产）：
buf := make([]byte, 16) ms := time.Now().UnixMilli() binary.BigEndian.PutUint64(buf[:8], uint64(ms)<<16) // 48-bit ts left-aligned buf[6] = (buf[6] & 0x0F) | 0x70 // set version=7 buf[8] = (buf[8] & 0x3F) | 0x80 // set variant=2 (0b10xxxxxx) _, _ = rand.Read(buf[8:]) // fill rest — but this is weak
v7 的“有序性”只在毫秒级窗口内成立，跨毫秒的 ID 不保证字典序连续；真正需要强单调递增的场景，仍需额外协调（如数据库 sequence 或 Redis INCR）。
