thread_local变量必须具有静态存储期，只能定义为全局、命名空间作用域变量或static局部变量；需手动初始化不同种子以防随机序列重复；uniform_int_distribution无需thread_local，因其无状态。
thread_local变量必须是静态存储期，不能在函数内直接定义
很多人一上来就在函数里写 thread_local std::mt19937 rng，编译直接报错：error: 'thread_local' variable declaration not allowed in local scope。这是因为 thread_local 只能修饰具有静态存储期的变量——也就是全局变量、静态成员变量或 static 局部变量。
正确做法只有两种：
- 声明为
static thread_local std::mt19937 rng（函数内静态局部变量） - 声明为全局或命名空间作用域下的
thread_local std::mt19937 rng
推荐用前者，封装性更好，避免污染全局命名空间。
每次线程首次访问时必须初始化，否则种子相同导致序列重复
thread_local 变量在线程首次访问时构造，但默认构造的 std::mt19937 使用固定种子（通常是 5489），所有线程会生成完全相同的随机数序列——这是最常被忽略的坑。
立即学习“C++免费学习笔记（深入）”；
必须手动用线程安全的方式提供不同种子。常见可靠做法：
- 用
std::random_device生成种子：std::random_device{}()（注意：不是每个平台都真正熵源丰富，但足够区分线程） - 结合线程 ID 哈希：
std::hash<:thread::id>{}(std::this_thread::get_id())</:thread::id>，确保不同线程一定不同 - 两者组合更稳妥：
std::random_device{}() ^ std::hash<:thread::id>{}(std::this_thread::get_id())</:thread::id>
示例：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
static thread_local std::mt19937 rng([]{
return std::random_device{}() ^
std::hash<std::thread::id>{}(std::this_thread::get_id());
}());
配合 uniform_int_distribution 使用时，distribution 本身不必 thread_local
std::uniform_int_distribution 是无状态的：它不保存内部状态，只依赖传入的引擎。所以多个线程共用同一个 static const 分布对象完全安全，且节省内存和构造开销。
错误写法（冗余且易出错）：
static thread_local std::uniform_int_distribution<int> dist(1, 100);
正确写法：
static thread_local std::mt19937 rng(...); static const std::uniform_int_distribution<int> dist(1, 100); // 线程内调用： int x = dist(rng); // 安全、高效
如果 distribution 参数需运行时确定（比如范围随线程变化），再考虑 thread_local，否则没必要。
注意 std::random_device 构造开销与平台差异
std::random_device 在某些平台（如旧版 MinGW 或某些容器环境）可能退化为伪随机，甚至每次调用返回相同值。如果发现多线程下仍出现重复序列，先验证它是否真随机：
std::random_device rd; std::cout << rd() << " " << rd() << " " << rd() << "\n"; // 多次运行看是否真变化
若不可靠，改用 std::chrono::steady_clock::now().time_since_epoch().count() 作为种子辅助项更实际；但注意别单独用它——纳秒级时间在快速启动的线程中可能碰撞，务必与线程 ID 混合。
真正麻烦的是调试场景：单线程测试时 thread_local 行为正常，一上多线程就出问题，往往卡在种子初始化这一步。建议把种子生成逻辑单独抽成函数并加日志，确认每条线程拿到的种子确实不同。
