mathrandv2使用新版随机数源

如果项目还在用 math/rand，又想把随机数调用迁移到新版 API，关键不是把包名机械替换成 math/rand/v2，而是先分清三种需求：普通业务随机、测试中的可复现序列，以及登录令牌这类安全敏感随机。math/rand/v2 适合前两类，安全敏感场景仍应使用 crypto/rand。

官方地址：https://pkg.go.dev/math/rand/v2

在 Go 1.22 及以上，普通随机调用可以直接使用 rand.IntN；需要固定结果时，创建一个局部的 rand.Rand 和 rand.PCG，不要再依赖全局 Seed。

先把旧包和新版包分开看

math/rand/v2 是 Go 1.22 加入标准库的独立导入路径。它不是旧包的别名，因此同一个文件里如果同时引用两者，需要使用不同的包名别名；更常见的做法是按模块的最低 Go 版本逐步迁移。

新版 API 去掉了旧式的顶层 Seed 迁移思路，Source 也只需要提供 Uint64。顶层随机函数使用默认源，官方不承诺固定输出序列，这让实现可以继续优化，但也意味着不能把某一次运行的随机结果写成测试期望值。

普通业务直接使用 IntN 和顶层函数

抽签、随机展示、测试数据扰动等场景通常不需要自己创建源。IntN(n) 返回半开区间 [0,n) 的整数，参数必须大于 0；浮点数则使用 Float64。这样写的好处是调用点短，也不会把可变的随机源暴露给多个业务对象。

package main

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

func main() {
	// IntN 的结果范围是 [0, 10)，适合做下标或抽签编号。
	index := rand.IntN(10)
	// Float64 返回 [0, 1) 的伪随机浮点数。
	weight := rand.Float64()
	fmt.Printf("index=%d weight=%.3f\n", index, weight)
}

这里不要把 IntN(10) 理解成会返回 10；上界永远不包含在结果内。如果传入 0 或负数，函数会 panic，所以外部配置决定范围时，应先校验业务参数，而不是让异常落到随机库内部。

测试需要固定序列时创建局部随机源

新版包仍然支持可控的伪随机序列，但控制点从全局状态转为显式实例。rand.NewPCG 创建一个 PCG 源，再交给 rand.New 得到 *rand.Rand。只要两个种子和调用顺序相同，同一版本环境下就能得到可复现序列；业务代码不应把这个序列当作跨版本永久协议。

package main

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

func main() {
	// 两个种子只服务于这一个实例，测试之间不会争用全局状态。
	source := rand.NewPCG(21, 34)
	r := rand.New(source)
	for i := 0; i 

测试中可以把 *rand.Rand 作为依赖传入生成器，生产代码则为每个独立工作单元创建自己的实例。这样比在测试开始处修改全局随机状态更容易隔离，也不会影响同进程的其他测试。

并发和安全场景不能混用

顶层函数适合并发调用；自己创建的 Rand 和底层 Source 不应被多个 goroutine 直接共享。若确实要共享，应在外部加锁，或者更简单地为每个 worker 分配独立实例。否则即使代码能编译，随机序列的访问边界也会变得不清楚。

另一个边界更重要：math/rand/v2 产生的是适合模拟和业务扰动的伪随机数，不适合密码、会话令牌、找回链接或抽奖防作弊。安全敏感数据应该改用 crypto/rand，不要因为“新版”三个字就自动获得安全随机性。

按三个问题完成迁移

第一，确认模块最低 Go 版本是否达到 1.22；如果还要兼容更早版本，先保留旧包，避免在依赖约束未调整时直接改导入路径。第二，搜索并改写 Seed、Intn 等旧调用，普通调用迁移到 IntN，需要复现的调用改为显式 Rand。第三，检查所有随机值的用途，涉及安全属性的代码单独迁移到 crypto/rand。

我更推荐把“随机源选择”放在业务边界上，而不是在工具包里偷偷持有一个全局实例：调用方可以从函数签名看出是否需要可复现，测试也能独立控制种子。迁移完成后，重点回归范围上界、空集合、并发访问和安全用途这四类情况。

相关问题

math/rand/v2 能生成密码安全随机数吗？不能。它是伪随机库；密码、令牌和密钥请使用 crypto/rand。

为什么不建议给全局随机源重新 Seed？新版顶层函数不以全局 Seed 作为主要控制方式，而且全局状态会让测试和并发调用互相影响。需要复现时创建局部 Rand 更清楚。

IntN 的参数为 0 会返回什么？不会返回默认值，而是触发 panic。范围来自配置或用户输入时，应先在业务层拒绝无效范围。