js Object.keys获取键

2026-05-14 02:00:30 606阅读 0评论

Object.keys 真的只是拿个数组？聊聊那些容易被忽略的细节

在日常前端开发里，Object.keys 大概是最常用的工具之一了。拿到一个对象，想遍历它的属性名？一行代码搞定：Object.keys(obj)。简单、直接，很多人用了好几年都没觉得有什么问题。直到某天遇到数据清洗或者私有属性处理时，才发现它返回的数组里少了一部分东西。

Object.keys 并不是万能的钥匙，它有自己的脾气和边界。如果不搞清楚这些细节，生产环境里很容易埋下隐患。

别忽略了“继承”这条线

很多初学者容易混淆 Object.keys 和 for...in 循环。如果你定义了一个子对象继承了父对象的配置，用 for...in 可以遍历到原型链上的属性，但 Object.keys 只返回对象自身的可枚举属性。

比如你在组件里混入了默认配置，通过原型链合并到了组件实例上。这时候如果想统计当前组件实际覆盖了多少配置项，直接用 Object.keys 会发现数量不对，因为它把父类的配置给过滤掉了。若你需要包含原型链属性，要么手动处理原型链，要么改用 for...in，但这又得小心配合 hasOwnProperty 去重。这种差异在处理深层配置对象时尤其明显，务必确认你需要的到底是“自身拥有的”还是“所有能访问到的”。

符号键值的隐身术

现代 JavaScript 开发中，为了模拟私有字段，不少团队开始使用 Symbol 作为对象的键。这本来是个好主意，用来防止外部意外修改内部状态。但 Object.keys 完全忽略 Symbol 类型的键。

想象这样一个场景：你在 Redux 的 state 里用 Symbol 存了一些元数据标记，调试时通过 JSON.stringify(Object.keys(state)) 输出日志，结果发现日志里空荡荡的，少了关键信息。这并不是 Bug，而是设计如此。如果你希望获取包含 Symbol 键在内的所有键名，Object.keys 就不再适用了。

数字键会自动变字符串

还有一个常被忽视的现象：虽然 JS 对象键在底层被视为字符串，但你传入 Object.keys 时如果定义了数字形式的键，拿到数组后它们依然是以字符串形式存在。

const obj = { 1: 'a', 2: 'b' };
console.log(Object.keys(obj)); 
// 输出 ['1', '2'] 而不是 [1, 2]

在做后端数据映射或者严格类型检查时，这个类型转换可能会导致判断逻辑失效。比如你以为用 arr.includes(1) 就能找到，结果只能匹配 "1"。处理这类数据前，最好统一规范键的数据类型，避免后续比对时的隐式转换带来的困惑。

当需要“全量”密钥时

既然 Object.keys 有这么多限制，有没有更彻底的方法？答案是 Reflect.ownKeys。

这个方法不仅涵盖自有属性，还能捕捉到不可枚举的属性以及 Symbol 类型的键。它更接近于对象的“完整指纹”。如果你的业务场景涉及元编程、框架底层开发，或者需要精确克隆对象的所有状态，建议优先考虑 Reflect.ownKeys。

const sym = Symbol('secret');
const obj = Object.create(null);
obj.normal = 1;
Object.defineProperty(obj, 'hidden', { value: 2, enumerable: false });
obj[sym] = 3;

console.log(Object.keys(obj));        // ['normal']
console.log(Reflect.ownKeys(obj));    // ['normal', 'hidden', Symbol(secret)]

看到对比就能明白，后者给出的信息量显然更大。