Go — map 迭代顺序随机导致测试抖动

消除 map 迭代顺序随机化导致的 Go 测试抖动，用 -count 与乱序运行检测此类问题，并在需要顺序处排序键。

症状

　　这种抖动有“比率”而没有单次失败日志里可见的原因：count=50 跑出 47 过 3 挂，同代码同输入，失败信息显示同一组元素的两种排列（got “a,b,c” want “c,a,b”）。固定失败率是随机顺序的指纹——时序竞态的形态不同，会随负载加重而恶化。顺着 got 字符串的构造溯源，几乎总能找到一个 for k := range m 喂给 strings.Join 或 Marshal 的调用。

诊断思路

　　先用 -count=50 量化抖动率，区分“稳定比率”（随机化）与“随负载增长”（时序竞态）；再 grep 所有 map range 与 Join/Marshal 的组合点，那是输出顺序随运行而变的精确构造；最后排序后重跑 50 遍，连续全过同时确认诊断与修复。

根因

　　Go 运行时故意随机化 map 迭代的起点与顺序，以防程序依赖顺序。任何顺序来自 map range 的输出都是非确定的，对固定期望的断言按“排列数量比例”的速率失败。

修复与验证

　　在组装点排序：slices.Sorted(maps.Keys(m))（Go 1.21+）得到确定性顺序再 Join；顺序无关紧要时按集合比较，让测试编码真实契约；JSON 输出路径优先用字段顺序固定的 struct 而不是键序随机的 map——稳定性归属于序列化器，而不是每个调用者记得排序。验证时 -count=100 零失败；CI 加一个周期性高 count 运行易抖包的作业。警惕“今天恰好有序”的比较——那编码的是未文档化的依赖，测试你真正想要的契约（有序或集合）。

代码示例

$ go test -count=50 -run TestBuildOrder ./gen/
--- FAIL: TestBuildOrder (0.00s)
    gen_test.go:28: got "a,b,c" want "c,a,b"
FAIL
# 47 passed, 3 failed

import (
    "maps"
    "slices"
)

keys := slices.Sorted(maps.Keys(m))   // deterministic order
out := strings.Join(keys, ",")

diff := cmp.Diff(
    slices.Sorted(maps.Keys(want)),
    slices.Sorted(maps.Keys(got)),
)