登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go math/rand/v2 PCG.Seed 怎样重现随机序列

来源:17golang原创

时间:2026-11-17 03:44:27 337浏览 收藏

如果测试用例依赖随机数据,却在第二次运行时换了一组输入,排查会很快失去方向。Go 的 math/rand/v2 可以让这类伪随机过程固定下来:先用两个 uint64 种子创建 PCG,需要重新开始时再调用 PCG.Seed(seed1, seed2)。它会把已有生成器重置到与 NewPCG(seed1, seed2) 相同的状态。

官方地址:https://pkg.go.dev/math/rand/v2#PCG.Seed

复现随机序列的关键不是保存某一次输出,而是固定种子、固定读取顺序,并在需要重放时把同一个 PCG 重置回相同状态。PCG 适合测试、模拟和样例数据,不适合生成密码、令牌或会话密钥。

先把复现链路拆开

PCG.Seed 只负责重置底层生成器,业务代码通常通过 rand.New 把它包装成 *rand.Rand,再调用 IntN、Uint64 等方法取值。把这三层分开后,复现失败通常就能归因到种子、生成器状态或消费次数。

Go math rand v2 中 seed1 seed2、PCG、rand.New、Rand 和 Uint64 的静态关系说明图
图1:PCG 可复现调用关系的静态说明图,不是截图或运行证据。
  • seed1 和 seed2 是两个独立的 uint64 输入。
  • *rand.PCG 保存伪随机生成器状态;零值 PCG 等价于 NewPCG(0, 0)。
  • rand.New 只是把源包装成便于读取的 *rand.Rand,不会替你固定业务读取顺序。

用固定种子建立第一段序列

下面的封装把种子集中在构造函数中,调用方只拿到 *rand.Rand。示例故意使用普通伪随机接口,重点是状态管理,不是产生安全随机数。

package main

import (
    "fmt"
    "math/rand/v2"
)

func newTestRand() *rand.Rand {
    // 两个固定种子决定 PCG 的初始状态,适合测试和可复现模拟。
    pcg := rand.NewPCG(12, 34)
    // Rand 负责提供 IntN、Uint64 等更方便的读取方法。
    return rand.New(pcg)
}

func main() {
    r := newTestRand()
    // 读取顺序也是复现条件的一部分,先取两个值再取一个范围值。
    fmt.Println(r.Uint64())
    fmt.Println(r.Uint64())
    fmt.Println(r.IntN(100))
}

同一版本的 Go、同一对种子和同一组读取调用,会从同一个初始状态开始。不要只记录第一行输出却漏掉中间调用,因为每一次读取都会推进生成器状态。

用 Seed 把已经使用过的 PCG 重置

当测试需要在同一个用例里重放一段随机输入时,可以保留 *rand.PCG,在第二轮开始前调用 Seed。它不需要重新创建 *rand.Rand,包装器仍然引用同一个 PCG。

package main

import (
    "fmt"
    "math/rand/v2"
)

func readThree(r *rand.Rand) [3]uint64 {
    // 固定三次读取,便于比较两轮序列是否完全一致。
    return [3]uint64{r.Uint64(), r.Uint64(), r.Uint64()}
}

func main() {
    pcg := rand.NewPCG(12, 34)
    r := rand.New(pcg)

    first := readThree(r)
    // 使用相同的两个种子,把 PCG 恢复到与 NewPCG 相同的初始状态。
    pcg.Seed(12, 34)
    second := readThree(r)

    fmt.Println(first == second)
}

这里比较的是两轮读取得到的数组,而不是比较 pcg 指针。重置之后 r 仍然通过原来的包装器读取数据,所以调用方不必重新组装整条依赖链。

Seed 重置的本质是回到同一初始状态

官方文档把 Seed(seed1, seed2) 定义为“重置 PCG,使它表现得像 NewPCG(seed1, seed2)”。可以把它理解成把内部的 128 位状态重新设置到同一入口;它不会把已经返回给业务的值收回,也不会自动修正已经发生的读取次数。

Go PCG 的 NewPCG 和 Seed 指向相同初始状态并产生可重复输出序列的关系说明图
图2:NewPCG、PCG.Seed、内部状态和输出序列的静态关系图,不是截图或运行证据。
变化对序列的影响排查重点
两个种子都相同从相同初始状态开始继续检查读取顺序
任意一个种子不同得到另一条序列检查配置、测试参数和默认值
读取次数不同后续位置发生偏移检查条件分支和额外消费
多个 goroutine 共享 Rand消费顺序可能受调度影响为测试隔离生成器或固定调用边界

复现失败时先查三件事

第一,确认两轮是否真的传入同一对 uint64。不要把字符串哈希、系统时间或测试编号混在种子生成逻辑里,否则外层输入已经变化。

第二,逐个对照读取点。一次新增的 IntN、一次提前返回,都会让后面的值落在不同位置。把随机读取集中在一个小函数中,通常比在业务分支里到处调用更容易重放。

第三,检查是否在重置前更换了 *rand.Rand 或底层 PCG。Seed 只作用于被调用的那个 PCG;如果业务持有多个生成器,必须明确重置哪一个。

固定种子不等于安全随机

math/rand/v2 的定位是伪随机数生成。固定种子本身还会让输出可预测,因此适合单元测试、模拟、演示数据和可复现的基准输入,不适合密码、验证码、访问令牌或需要不可预测性的安全场景。

如果任务需要安全随机字节,应改用 crypto/rand,并根据业务接口处理读取错误。不要因为 PCG 的输出看起来分散,就把它当成安全随机源。

几个容易混淆的问题

Seed 调用后需要重新 rand.New 吗?

不需要。只要 rand.New 包装的还是这个 PCG,调用 pcg.Seed 后继续使用原来的 *rand.Rand 即可。

只保存一项随机结果能恢复整段序列吗?

不能。结果值不等于完整生成器状态。要重放整段行为,应保存种子和读取顺序,或在测试边界重新调用 Seed。

两个种子需要来自同一个随机源吗?

不需要,但要在可复现测试中明确记录它们。它们共同决定 PCG 的起始状态,换掉其中一个就会改变后续序列。

总结

PCG.Seed(seed1, seed2) 的价值在于把一个已推进的生成器恢复到可预期起点。实践中只要同时固定两项种子、读取顺序和生成器边界,就能稳定重现测试与模拟输入;如果序列仍然不同,优先排查额外读取、条件分支和并发消费。最后记住用途边界:PCG 是可复现的伪随机工具,不是安全随机源。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>