crypto/rand.Int 生成范围内随机数的实现方式

在 Go 中需要生成一个范围内的安全随机数，可以直接调用 crypto/rand.Int。它接收一个 io.Reader 和一个 *big.Int 类型的上界，返回均匀分布在 [0,max) 内的 *big.Int。也就是说，上界不包含在结果里；例如 max=100 时，结果范围是 0 到 99。

最小写法是 n, err := rand.Int(rand.Reader, big.NewInt(100))。上界必须大于 0，读取随机源的错误要正常返回；如果结果只用于小范围编号，再确认范围适合后调用 Int64()。

• 函数入口：crypto/rand.Int(rand io.Reader, max *big.Int)。
• 范围语义：结果属于 [0,max)，不包含 max。
• 类型边界：上界和结果都是 big.Int，普通整数上界可用 big.NewInt 构造。
• 安全边界：需要不可预测随机数时使用 crypto/rand，模拟或普通抽样再考虑 math/rand/v2。

官方资料：https://pkg.go.dev/crypto/rand

用 rand.Int 生成 [0,max) 内的安全随机数

rand.Reader 是 crypto/rand 提供的全局安全随机源，可以作为第一个参数传给 rand.Int。第二个参数不是 Go 内置的 int，而是 *big.Int；对于常见的正数上界，用 big.NewInt 最直接。

package main

import (
    "crypto/rand"
    "fmt"
    "math/big"
)

func main() {
    // big.NewInt(100) 表示上界 100，结果只能落在 0 到 99。
    n, err := rand.Int(rand.Reader, big.NewInt(100))
    if err != nil {
        // 随机源出错时把错误交给调用方，不要把零值当成随机结果。
        panic(fmt.Errorf("生成安全随机数失败: %w", err))
    }
    fmt.Println(n.String()) // n 是 *big.Int，先按字符串输出更稳妥。
}

这里的 rand 参数表示随机字节从哪里来，max 只负责限定结果上界。不要把 big.NewInt(100) 理解成“生成 100 位数字”，它代表的是数值 100。若上界是 1，函数只能返回 0；若上界是 10，函数只能返回 0 到 9。

max、错误和结果类型怎么处理

官方文档规定，max 时 rand.Int 会 panic，而随机源读取失败时返回错误。对来自配置、请求或数据库的上界，先在业务层检查更容易给出可理解的错误，而不是把不合法输入直接传进函数。

package randomid

import (
    "crypto/rand"
    "errors"
    "fmt"
    "math/big"
)

var ErrInvalidMax = errors.New("随机数上界必须大于 0")

// SecureIntInRange 生成 [0,max) 内的安全随机数，并把输入错误显式返回。
func SecureIntInRange(max int64) (int64, error) {
    if max 

如果上界本身可能超过 int64，不要强行把结果转成 Int64()。可以用 new(big.Int).SetString 解析大整数上界，并继续保留返回的 *big.Int，或调用 String() 传输十进制文本。这样不会因为结果类型过小而丢失高位。

安全随机数和普通随机数不要混用

crypto/rand 适合令牌、验证码、不可预测的抽样或安全相关标识；它的结果来自密码学安全随机源，调用链也因此带有读取错误。若只是游戏动画、模拟数据或测试中的可复现抽样，应根据需要选择 math/rand/v2，而不是为了所有场景都使用同一个 API。

选择时可以记住三个判断：第一，结果一旦被攻击者猜中会不会造成问题；第二，是否需要通过种子复现；第三，上界是否超过内置整数的表达范围。前两个答案决定随机源类型，最后一个答案决定是否保留 *big.Int。

常见问题

rand.Int( rand.Reader, big.NewInt(10) ) 会返回 10 吗？

不会。返回区间是左闭右开 [0,10)，因此只可能得到 0 到 9。

为什么不能直接传 int 作为上界？

函数签名要求 *big.Int。小范围上界可以用 big.NewInt 构造；如果数据来自字符串或超出 int64，则应使用 SetString 创建大整数。

max 不合法时应该捕获 panic 吗？

更好的方式是在进入 rand.Int 前检查业务输入并返回错误。固定常量可以直接保证为正；外部输入则不要依赖 panic 作为正常控制流。

因此，crypto/rand.Int 的关键不是记住一段固定代码，而是同时理解上界类型、[0,max) 区间和错误边界。小范围场景用 rand.Reader + big.NewInt 即可；大整数场景保留 *big.Int，普通模拟场景再选择可复现的伪随机 API。