Go crypto/rand.Int 如何生成无偏随机下标：上界参数与错误处理边界

给一个长度为 37 的切片抽随机元素时，最容易写错的不是函数名，而是把“最后一个下标”当成上界传给 crypto/rand.Int。这个函数返回的是 [0, max) 内的均匀随机数，所以正确上界应该是切片长度 37，而不是 36。

rand.Int(rand.Reader, big.NewInt(37)) 可能返回 0 到 36；max 必须大于 0，返回值是 *big.Int，读取随机源失败时要处理 error。

先把随机下标的边界说清楚

crypto/rand.Int 的签名是 Int(rand io.Reader, max *big.Int) (*big.Int, error)。它从给定的随机读取器取值，并把结果限制在 [0, max)；因此长度为 37 的序列对应 37 个候选下标，范围正好是 0 到 36。

package main

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

func pickIndex(length int) (int, error) {
    if length 

这里的调用链很短：length 先变成正数上界，crypto/rand.Reader 提供随机字节，rand.Int 返回一个 *big.Int，最后才转换为 Go 的 int。转换发生在范围已经被限制之后，避免自己用取模操作破坏分布。

为什么不能用随机字节直接取模

如果候选数量不是 2 的幂，字节空间通常不能被候选数量整除。直接写 byte % length 会让某些下标更容易出现。rand.Int 内部会拒绝不完整的高位区间，再接受落在目标范围内的值，换来的就是均匀结果。

所以这段代码不要改成“先读一个字节再取模”：

// 不推荐：当 length 不能整除 256 时会产生偏差
index := int(randomByte) % length

如果只是普通抽样，math/rand 更轻量；如果结果会影响验证码、邀请号、抽签公平性或安全边界，应使用 crypto/rand。两者解决的问题不同，不能只看函数名都叫随机。

big.Int 转 int 时检查什么

rand.Int 返回 *big.Int，因为它支持大于机器字长的上界。对切片、数组或字符串下标来说，长度通常是 int，因此在传入前用 int64(length) 构造 big.Int，返回后用 Int64() 取出即可。

关键顺序不能颠倒：先拒绝空集合，再调用随机函数；先判断 err，再访问 n.Int64()。若 max 来自请求参数，不能直接把 0 或负数交给 rand.Int，因为官方约定是这类上界触发 panic，而不是返回普通错误。

把错误路径留给调用方决定

使用默认的 crypto/rand.Reader 时，常规平台上读取失败并不常见，但函数签名仍然保留了 error。不要写成无条件忽略：

n, _ := cryptorand.Int(cryptorand.Reader, big.NewInt(37))
return choices[int(n.Int64())]

更稳妥的做法是让业务函数返回 (T, error)，由上层决定重试、降级还是记录失败。测试时也可以注入一个始终返回错误的 io.Reader，确认错误会沿着调用链传出去，而不是变成一个看似正常的下标。

常见问题：几个容易混淆的答案

max 传 36 能不能得到 36？

不能。返回范围是 [0, 36)，最大值是 35；需要覆盖 0 到 36 时应传 37。

为什么返回 *big.Int 而不是 int？

因为上界参数支持任意精度整数。小范围下标可以在边界已验证后调用 Int64()。

空切片应该怎么处理？

在调用 rand.Int 之前返回业务错误或采用明确的空结果策略，不能把 0 传给 max。

crypto/rand.Int 适合替代所有随机函数吗？

不适合。安全敏感或公平性敏感的结果用它；可复现模拟、普通洗牌和性能敏感场景应按需求选择伪随机方案。

最后做一次边界核对

把“候选数量”当成上界，把 [0, max) 当成固定规则，再把错误和空输入分开处理，这个小函数就不容易在生产里留下隐蔽的越界或分布偏差。需要安全随机下标时，保留 Reader → max 校验 → rand.Int → error → Int64 这条路径即可。