2026-04-22 15:44:58 +08:00
|
|
|
# Test Report: @go/id
|
|
|
|
|
|
|
|
|
|
## 📋 测试概览
|
2026-05-01 20:42:15 +08:00
|
|
|
- **测试时间**: 2026-05-01
|
2026-04-22 15:44:58 +08:00
|
|
|
- **测试环境**: darwin/amd64 (Intel i9-9980HK)
|
|
|
|
|
- **Go 版本**: 1.25.0
|
|
|
|
|
|
|
|
|
|
## ✅ 功能测试 (Functional Tests)
|
|
|
|
|
| 场景 | 状态 | 描述 |
|
|
|
|
|
| :--- | :--- | :--- |
|
2026-05-01 20:42:15 +08:00
|
|
|
| `TestMakeID` | PASS | 生成长度符合预期的通用 ID。 |
|
2026-04-22 15:44:58 +08:00
|
|
|
| `TestGetForMysql` | PASS | 生成 MySQL 友好主键,包含右旋散列逻辑。 |
|
|
|
|
|
| `TestGetForPostgreSQL`| PASS | 生成 PostgreSQL 友好主键,无右旋散列。 |
|
|
|
|
|
|
|
|
|
|
## ⚡ 性能基准 (Benchmarks)
|
2026-05-01 20:42:15 +08:00
|
|
|
| 函数 | 平均耗时 |
|
|
|
|
|
| :--- | :--- |
|
|
|
|
|
| `MakeID-10` | **1572 ns/op** |
|
|
|
|
|
| `GetForMysql-10` | **1552 ns/op** |
|
2026-04-22 15:44:58 +08:00
|
|
|
|
|
|
|
|
* 集成 `@go/rand` 的 `FastInt` 优化,在高并发下彻底规避了锁竞争。
|
|
|
|
|
* ID 生成性能稳定,满足高性能主键生成场景。
|
|
|
|
|
|
|
|
|
|
## 🛡️ 鲁棒性防御 (Robustness)
|
2026-05-01 20:42:15 +08:00
|
|
|
- **并发安全**:核心计数器使用 `sync.Mutex` 保护。
|
2026-04-22 15:44:58 +08:00
|
|
|
- **碰撞防御**:秒级重置机制配合随机偏移初始化,极大地降低碰撞概率。
|
|
|
|
|
- **扩展性**:支持自定义钩子,轻松对接 Redis 等分布式协调服务。
|