array_intersect_key 本质是按键名交集匹配，只比较键名是否同时存在于所有数组中，忽略值；返回首个数组中对应键的键值对，键名严格区分类型和大小写。
array_intersect_key 本质是“按键匹配”，不是按值
它只比较键名（key），完全忽略数组的值（value）。哪怕两个数组的值天差地别，只要键名有重合，就计入结果。这点和 array_intersect 完全不同——后者比的是值，键名只是附带信息。
常见误用场景：想找出“值相同且键也相同的元素”，结果用了 array_intersect_key，发现返回一堆值完全不对的项。这时候该用 array_intersect_assoc 或手动 foreach + 条件判断。
- 输入数组必须是关联数组；索引数组（如
[1,2,3]）会被 PHP 自动转成键为0,1,2的形式参与比较 - 第一个参数是“基准数组”，只有它的键出现在后续所有数组中时，该键值对才会被保留
- 返回结果保留第一个数组中的值，不取其他数组的对应值
多数组交集时，所有键必须同时存在
array_intersect_key 支持传入任意多个数组，但逻辑是“交集”：某个键必须在 所有 数组中都存在，才进入结果。少一个都不行。
比如你传了三个数组：$a、$b、$c，那么只有那些同时是 $a、$b、$c 键名的项才会被返回。
- 空数组参与时，结果一定是空数组（因为“所有数组都含该键”无法满足）
- 如果某数组是
null或非数组类型，会触发 warning 并被跳过（PHP 8+ 会报TypeError） - 键名区分大小写：
'ID'和'id'被视为不同键
$a = ['name' => 'Alice', 'age' => 30, 'city' => 'Beijing']; $b = ['name' => 'Bob', 'age' => 25]; $c = ['name' => 'Charlie', 'city' => 'Shanghai']; $result = array_intersect_key($a, $b, $c); // 返回 ['name' => 'Alice'] —— 只有 'name' 同时存在于 $b 和 $c 中
注意字符串键和数字键的隐式转换
PHP 在比较键时会做类型松散转换，这容易引发意外结果。例如字符串 '1' 和整数 1 在某些上下文中会被认为相等，但在 array_intersect_key 中不会——它严格按类型+值匹配键。
不过要注意：如果你用数字字符串作为键（比如 ['1' => 'a', '2' => 'b']），而另一个数组用整数键（[1 => 'x', 2 => 'y']），它们不会匹配。因为 '1' 是 string，1 是 integer。
- 用
var_dump(array_keys($arr))确认键的实际类型，比凭眼猜更可靠 - 避免混用
0和'0'、1和'1'作键名 - 从 JSON 解码来的数组默认键是字符串，直接和原生整数键数组做
array_intersect_key很可能为空
替代方案：需要“键存在且值相等”怎么办
如果你真正想要的是“键相同且对应值也相等”的交集，array_intersect_key 不适用。这时有两个更贴切的选择：
- 用
array_intersect_assoc：它同时校验键和值，但要求所有数组结构一致，且只接受两个参数（可嵌套调用） - 手写循环 +
isset+ 值比较：灵活可控，适合复杂条件（比如忽略大小写、浮点容差等）
$a = ['name' => 'Alice', 'age' => 30];
$b = ['name' => 'Alice', 'city' => 'NYC'];
// 下面这行不会返回任何东西，因为 'age' 不在 $b 中
$result1 = array_intersect_key($a, $b);
// 想要 name 相同且值也相同？得这样：
$result2 = [];
foreach ($a as $k => $v) {
if (isset($b[$k]) && $b[$k] === $v) {
$result2[$k] = $v;
}
}
// $result2 = ['name' => 'Alice']
最常被忽略的一点：这个函数不递归，也不处理多维数组的子键。如果你有一堆嵌套配置，想按路径做键交集，得自己写递归逻辑或用 array_walk_recursive 配合路径追踪。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
