shuffle() 直接打乱原数组并返回布尔值，不保留关联键；需用array_rand()+array_replace等组合保留键名，或Fisher-Yates算法实现可重现随机序。
直接用 shuffle() 就行，但要注意它会修改原数组
shuffle() 是 PHP 内置函数，专为打乱索引数组设计。它不返回新数组，而是直接在原数组上操作，并返回 true 或 false 表示是否成功。
常见错误是以为它像 JavaScript 的 sort(() => Math.random() - 0.5) 那样返回新数组，结果写成 $new = shuffle($arr); —— 这样 $new 是布尔值，不是打乱后的数组。
- 必须传入变量（不能传表达式或字面量），比如
shuffle($arr)✔️，shuffle([1,2,3])❌ - 只重排数字索引，关联键（字符串键）会被重置为 0、1、2…，如果要保留键名，得用
array_keys()+array_rand()组合 - 对空数组或单元素数组调用是安全的，返回
true
想保留关联键？用 array_rand() 搭配 array_flip()
当数组是 ['a' => 1, 'b' => 2, 'c' => 3] 这类带字符串键的结构时，shuffle() 会丢掉 'a'、'b' 等原始键名。这时更稳妥的做法是先抽键，再按随机顺序取值：
$arr = ['a' => 1, 'b' => 2, 'c' => 3]; $keys = array_rand($arr, count($arr)); // 返回随机排列的键数组，如 ['b', 'a', 'c'] $result = array_merge(...array_map(fn($k) => [$k => $arr[$k]], $keys));
或者更简洁地（PHP 7.4+）：
立即学习“PHP免费学习笔记（深入）”；
$result = array_replace([], ...array_map(fn($k) => [$k => $arr[$k]], array_rand($arr, count($arr))));
注意：array_rand($arr, N) 的第二个参数不能超过数组长度，否则会警告；N 为 1 时返回单个键（非数组），需单独处理。
需要可重现的随机顺序？得手动设种子 + 用 mt_shuffle() 模拟
PHP 原生 shuffle() 底层用的是 mt_rand()，但不支持传入 seed。如果要做测试、导出固定随机序列（比如抽奖结果存档），就得自己实现：
- 先调用
mt_srand($seed)设定种子（注意：全局生效，会影响其他mt_rand()调用） - 生成索引数组
$indices = range(0, count($arr) - 1) - 用自定义比较函数配合
usort()打乱：usort($indices, fn($a, $b) => mt_rand() % 2 ? 1 : -1)（不推荐，分布不均） - 更可靠的是 Fisher-Yates 实现：
$indices = range(0, count($arr) - 1); for ($i = count($indices) - 1; $i > 0; $i--) { $j = mt_rand(0, $i); [$indices[$i], $indices[$j]] = [$indices[$j], $indices[$i]]; } $result = array_replace([], ...array_map(fn($i) => [$i => $arr[$i]], $indices));
性能和兼容性要注意这些点
小数组（shuffle() 完全没问题；大数组（>10 万）时，Fisher-Yates 手动实现比反复调用 mt_rand() 更可控，也避免 usort 的额外开销。
-
shuffle()在 PHP 8.2+ 中仍无变化，但已标记为“可能在未来版本中限制对引用传递的要求” - PHP 8.1+ 开始，传入非数组会抛
TypeError，之前是警告 + 返回false - 如果数组含对象或资源，
shuffle()照常工作，但要注意对象引用不会被复制，只是索引重排
最常被忽略的是：打乱前没检查数组是否为空或非数组，尤其从 API 或数据库取数据后直接 shuffle($data['items'])，一旦 $data['items'] 是 null 或字符串，就会报错或静默失败。
