33 lines
1.4 KiB
Markdown
33 lines
1.4 KiB
Markdown
|
# Test Report: @go/rand
|
|||
|
|
|
|||
|
|
## 📋 测试概览
|
|||
|
|
- **测试时间**: 2026-04-22
|
|||
|
|
- **测试环境**: darwin/amd64 (Intel i9-9980HK)
|
|||
|
|
- **Go 版本**: 1.25.0
|
|||
|
|
|
|||
|
|
## ✅ 功能测试 (Functional Tests)
|
|||
|
|
| 场景 | 状态 | 描述 |
|
|||
|
|
| :--- | :--- | :--- |
|
|||
|
|
| `TestGenericInt` | PASS | 验证泛型整数随机，覆盖正数、负数区间。 |
|
|||
|
|
| `TestFastInt` | PASS | 验证高性能并发模式下的正确性。 |
|
|||
|
|
| `TestBytes` | PASS | 验证随机字节生成。 |
|
|||
|
|
|
|||
|
|
## 🛡️ 鲁棒性防御 (Robustness)
|
|||
|
|
- **反向区间拦截**：`Int(100, 10)` 返回 `100`，未发生 Panic。
|
|||
|
|
- **负数区间支持**：`Int(-50, -10)` 逻辑正确，随机分布正常。
|
|||
|
|
- **非法切片长度**：`Bytes(-1)` 返回空切片，未发生溢出。
|
|||
|
|
|
|||
|
|
## ⚡ 性能基准 (Benchmarks)
|
|||
|
|
| 函数 | 平均耗时 | 性能红线 | 结论 |
|
|||
|
|
| :--- | :--- | :--- | :--- |
|
|||
|
|
| `Int` (单核) | **7.62 ns/op** | <50 ns/op | 🎯 极优 |
|
|||
|
|
| `FastInt` (并发) | **2.63 ns/op** | <5 ns/op | 🎯 极优 |
|
|||
|
|
|
|||
|
|
### 并发加速比分析
|
|||
|
|
在 16 核环境下，`FastInt` 通过 `sync.Pool` 彻底消除了锁竞争，单次随机生成的边际成本极低（~2.6ns），非常适合作为高频业务组件。
|
|||
|
|
|
|||
|
|
## 🔍 Self-Review 修正记录
|
|||
|
|
1. **逻辑清理**：移除了无用的 `Rand` 结构体和 `isFast` 字段，实现完全函数式 API。
|
|||
|
|
2. **命名修正**：将 `IntFast` 升级为符合人类语义的 `FastInt`。
|
|||
|
|
3. **测试纠错**：移除了 `TestBytes` 中针对 `uint8 < 0` 的无效断言。
|