Go math/rand/v2 ChaCha8 交错调用 Read 和 Uint64 的顺序边界

我在把随机整数和随机字节塞进同一份测试夹具时，最容易误判的一点是：同一个 math/rand/v2.ChaCha8，只要交错调用 Read 与 Uint64，就不能再把两次运行的字节排列当成协议保证。更稳妥的做法是先决定输出形态；需要字节就连续调用 Read，需要整数就连续调用 Uint64，确实要混合时把调用顺序写进自己的协议。

先分清随机值和内部读取状态

NewChaCha8 接收一个 [32]byte 种子，返回独立的 *ChaCha8。这个对象同时提供面向整数的 Uint64、面向字节的 Read，还实现了二进制状态的序列化接口。它们不是三条互不相干的随机流水线，而是在推进同一个生成器状态。

因此，下面这张关系图只表达静态结构：种子建立生成器，生成器维护状态，两个方法从状态取值，快照接口保存或恢复状态。图中没有模拟真实运行顺序，也不是终端截图。

Read 和 Uint64 交错时，顺序边界在哪里

真正需要记住的是这条边界：官方文档不承诺 Read 和 Uint64 交错调用时返回位的顺序。也就是说，下面的写法可以编译，但不应该把 bytesA 与 number 的排列关系当作跨实现、跨版本的稳定协议。

package main

import "math/rand/v2"

func mixed(c *rand.ChaCha8) ([]byte, uint64) {
	var bytesA [5]byte
	// Read 负责填满字节缓冲区；这里不把它当成一次 Uint64 调用。
	_, _ = c.Read(bytesA[:])
	// Uint64 继续使用同一个生成器状态，交错关系不应被外部协议依赖。
	number := c.Uint64()
	return bytesA[:], number
}

问题不在返回值是否完整：Read 会返回切片长度和空错误，Uint64 也会返回一个完整的 64 位值。问题在于两种读取方式对内部生成位的消费方式不同，文档没有给混合顺序作承诺。测试里如果只断言“每次调用都得到值”，通常没问题；如果断言跨调用的精确字节序列，就把不稳定边界写进了测试。

三种需求对应三种稳定写法

我更愿意把调用协议写在代码结构里，而不是靠注释提醒调用者。纯字节场景只让一个实例负责 Read；纯整数场景只走 Uint64。混合场景则使用两个有明确职责的实例，或者把所有输出先统一成字节再由上层解析。

package main

import "math/rand/v2"

func newSources(seedBytes, seedInts [32]byte) (*rand.ChaCha8, *rand.ChaCha8) {
	// 两个实例各自负责一种输出，避免调用方共享同一内部消费边界。
	byteSource := rand.NewChaCha8(seedBytes)
	intSource := rand.NewChaCha8(seedInts)
	return byteSource, intSource
}

func readToken(byteSource *rand.ChaCha8, intSource *rand.ChaCha8) ([]byte, uint64) {
	token := make([]byte, 16)
	// 字节协议只从 byteSource 读取，长度成为协议的一部分。
	_, _ = byteSource.Read(token)
	// 整数协议只从 intSource 读取，避免与 token 争用状态。
	return token, intSource.Uint64()
}

这里的两个种子不能简单复制后就声称“隔离完成”：工程上还要决定种子如何派生、是否需要把种子持久化，以及两类输出是否允许被同一份测试数据重放。文章只讨论调用边界，不把 math/rand/v2 当作密钥材料生成器。

可复现快照要连调用序列一起保存

MarshalBinary 能保存当前状态，但快照只解决“从哪里继续”，不会把不确定的混合调用变成稳定协议。要做回放测试，至少固定四件事：初始种子、每次方法的顺序、Read 的切片长度、快照发生在调用前还是调用后。

package main

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

func snapshot(c *rand.ChaCha8) ([]byte, error) {
	// 快照保存的是当前生成器状态，不是下一次输出的预览值。
	state, err := c.MarshalBinary()
	if err != nil {
		return nil, fmt.Errorf("保存 ChaCha8 状态: %w", err)
	}
	return state, nil
}

如果测试从快照恢复后改了读取长度，哪怕种子和快照完全一样，后续输出也不能拿旧基线比较。对混合输出尤其如此：要么把 Read 与 Uint64 的顺序作为版本化协议，要么把它们拆成职责单一的源。

常见问题

同一个种子每次运行结果一定完全一样吗？

只有在使用相同方法序列、相同读取长度和相同状态起点时，才适合比较精确输出。种子相同不等于调用协议相同。

可以把 ChaCha8.Read 当成安全随机数接口吗？

本文只讨论 math/rand/v2 的调用语义。需要密钥、令牌等安全材料时，应按用途选择专门的密码学随机源，不要从这里外推安全保证。

两个 ChaCha8 可以并发调用吗？

把不同实例分给不同任务更容易维护；同一个实例是否并发安全不能靠本文的顺序规则推断，应该遵守当前 Go 文档对该类型的使用约束，并在共享处加同步或改为每个任务独立实例。