回调函数必须返回整数而非布尔值：负数表示$a小于$b，0表示相等，正数表示$a大于$b；错误返回布尔值会导致排序错乱，正确做法是用$a<=>$b、strcmp()或显式返回-1/0/1。
回调函数返回值必须是整数，不是布尔值
很多人误以为 usort 或 uasort 的比较函数该返回 true/false，结果排序完全错乱。PHP 的排序回调函数（如 usort、uasort、usort 的第三个参数）**严格要求返回整数**：负数表示第一个参数“小于”第二个，0 表示相等，正数表示“大于”。
常见错误现象：
– 排序后顺序随机或部分颠倒
– 出现 Warning: usort(): Array was modified by the user comparison function
– 用 return $a > $b 这类布尔表达式，实际返回 1 或 0，缺失负值，破坏三路比较语义
- 正确写法始终是：返回
$a - $b（数值）、strcmp($a, $b)（字符串）、或显式return -1/0/1 - 对浮点数慎用减法，可能因精度导致非预期的正/负号，优先用
floatval($a) floatval($b)（PHP 7+） - 自定义对象比较时，不能依赖隐式转换，必须明确分支逻辑，例如：
function($a, $b) { if ($a->score === $b->score) return 0; return ($a->score < $b->score) ? -1 : 1; }
用飞船操作符（
PHP 7 引入的三路比较操作符 原生返回 -1/0/1，语义清晰、类型安全，且自动处理字符串、数字、null 的合理比较规则。
使用场景：
– 多数简单排序（数值、字符串、时间戳）
– 需要兼容 null 值（null 'abc' 返回 -1）
– 替代冗长的 if-else 分支
立即学习“PHP免费学习笔记（深入）”；
- 数值排序：
usort($arr, fn($a, $b) => $a['age'] $b['age']) - 字符串不区分大小写：
usort($arr, fn($a, $b) => strcasecmp($a['name'], $b['name']))（注意strcasecmp本身返回 -1/0/1） - 多级排序（先按 status，再按 created_at）：
usort($arr, function($a, $b) { $cmp = $a['status'] <=> $b['status']; return $cmp !== 0 ? $cmp : $a['created_at'] <=> $b['created_at']; });
返回值符号搞反会导致整个数组逆序
如果回调中把大小关系写反，比如本该 $a $b 却写了 $b $a，排序结果就是严格逆序——这不是 bug，是符合预期的行为。但容易被当成“没生效”而反复调试。
容易踩的坑：
– 在封装通用比较函数时，参数顺序传错（usort($arr, $callback) 中回调形参顺序固定为 ($a, $b)，代表“当前元素”和“被比较元素”）
– 混淆 usort（重索引）和 uasort（保留键名），但两者对回调返回值要求完全一致
- 调试技巧：临时在回调里加
var_dump($a, $b, $a $b)，看前几组输出是否符合你对“小→大”的直觉 - 性能影响：返回值类型错误（如返回字符串）会触发 PHP 类型转换警告，并可能降级为字典序比较，造成逻辑错误而非性能问题
- 兼容性注意：
在 PHP strcmp 或手动分支
对象属性为空或类型不一致时的返回值陷阱
当数组元素是对象，且某些对象缺失字段、字段为 null 或类型混杂（如有的 price 是字符串 "19.99"，有的是整数 20），直接 $a->price $b->price 可能返回意外结果。
原因： 对 null 和字符串数字有明确定义，但和业务语义未必一致（例如你希望 null 排最后，但 null 100 返回 -1，排最前）。
- 统一预处理：提前 cast 类型，如
(float) $a->price (float) $b->price - 空值控制：显式处理
null，例如function($a, $b) { $aPrice = $a->price ?? PHP_FLOAT_MAX; $bPrice = $b->price ?? PHP_FLOAT_MAX; return $aPrice <=> $bPrice; } - 避免隐式转换陷阱：不要依赖
$a->name $b->name处理中文，UTF-8 下没问题，但若含 GBK 字符或混合编码，strcmp更可控
排序回调的返回值本质是告诉 PHP “相对位置”，不是“是否交换”。只要记住 -1/0/1 的语义，再结合 <=> 或成熟字符串函数，基本不会翻车。最常出问题的，其实是没意识到字段可能为 null 或类型不一致，而不是返回值本身怎么写。
