在JavaScript里处理对象时，我们常常需要把对象自己的属性名全部列出来，用来做遍历、比对或者生成表单字段。Object.keys就是语言内置的一个静态方法，挂在Object构造函数上，专门用来获取对象自身的可枚举字符串属性键，并以数组形式返回。它不会去翻原型链，也不会把Symbol键算进去，这一点和for-in循环、Object.getOwnPropertyNames都不同。
Object.keys的基本定义与语法
Object.keys属于ECMAScript 5引入的标准方法，调用方式非常简单，只需要把一个目标对象传进去。如果传入的不是对象，在非严格模式下会被强制转换成对象，在严格模式下则直接抛错。返回值永远是一个数组，数组里的每一项都是字符串，对应对象自身可枚举属性的键名。
所谓“自身”是指不是从原型链继承来的，“可枚举”是指属性的enumerable描述符为true。大多数通过字面量或赋值方式添加的普通属性都是可枚举的，而像Object.prototype上的方法则不可枚举。下面看一个最基础的例子：
var user = {
name: '张三',
age: 28,
email: 'test@ipipp.com'
};
var keys = Object.keys(user);
console.log(keys); // ["name", "age", "email"]
console.log(Array.isArray(keys)); // true
从代码可以看出，Object.keys返回的就是一个普通的数组，因此我们可以直接使用数组的一切方法，比如map、filter、forEach。这也让它在函数式写法里非常顺手。
Object.keys与for-in的区别
很多初学者容易把Object.keys和for-in搞混，因为二者都能“列出属性”。但for-in会沿着原型链向上找，把继承来的可枚举属性也列出来；Object.keys只认对象自己的可枚举属性。如果不用hasOwnProperty做过滤，for-in就可能把原型上的方法名也遍历出来，造成逻辑错误。
下面的例子展示了这种差异。我们给一个构造函数的原型上加了一个方法，然后用两种方式分别获取属性：
function Person() {
this.name = '李四';
this.age = 30;
}
Person.prototype.sayHi = function() {};
var p = new Person();
// for-in 会拿到原型上的 sayHi
var forInKeys = [];
for (var k in p) {
forInKeys.push(k);
}
console.log(forInKeys); // ["name", "age", "sayHi"]
// Object.keys 只拿自身
console.log(Object.keys(p)); // ["name", "age"]
可以看到，Object.keys天然避开了原型污染的问题。如果你的目的只是处理当前对象自己的数据字段，用Object.keys比for-in加判断更直观，也更不容易出错。当然，如果你确实需要遍历继承属性，那还是得用for-in。
Object.keys的使用场景与示例
在实际项目中，Object.keys常见的用途包括：检查对象是否为空、提取字段做表单校验、把对象转成键值对数组、以及做简单的浅层对比。由于返回的是数组，我们可以配合length属性快速判断对象有没有自有可枚举属性。
比如一个配置对象可能在某些环境下没有任何字段，我们可以用Object.keys(config).length === 0来判断。再比如要把对象所有值提取出来发给后端之前，先确认包含哪些字段：
var config = {
timeout: 3000,
retry: 2
};
if (Object.keys(config).length === 0) {
console.log('配置为空，使用默认项');
} else {
var fields = Object.keys(config).map(function(key) {
return key + '=' + config[key];
});
console.log(fields.join('&')); // "timeout=3000&retry=2"
}
上面的代码先把键取出来，再用map拼成字符串，逻辑清晰。如果是深层对象对比，Object.keys也能帮我们先比键集合是否一致，再递归比值，避免直接序列化带来的顺序问题。
注意事项与边界情况
使用Object.keys时有几个容易踩坑的地方。第一，它不会返回Symbol类型的键，哪怕这个Symbol是自己对象上的可枚举属性。如果需要连Symbol一起拿，要用Object.getOwnPropertySymbols或者Reflect.ownKeys。第二，它只返回可枚举属性，用Object.defineProperty定义且enumerable为false的键不会出现。
第三，传入原始类型时，JavaScript会将其包装成对象，但原始类型的包装对象通常没有自有可枚举属性，所以返回空数组，而不会报错。看下面的例子：
console.log(Object.keys('abc')); // ["0", "1", "2"] 字符串有索引可枚举
console.log(Object.keys(123)); // [] 数字包装对象无自有可枚举属性
console.log(Object.keys(null)); // 报错 TypeError
字符串因为具备类数组的索引属性，所以会把0、1、2作为键返回；而数字和布尔包装后没有可枚举自有属性，得到空数组。但是传null或undefined会直接抛TypeError，因此在不确定入参时，最好先做类型保护，例如使用typeof判断或者给默认值。
小结
Object.keys是一个轻量、安全、语义明确的对象键提取工具。它只返回对象自身的可枚举字符串属性，不涉及原型链和Symbol，返回数组便于后续处理。在表单处理、配置检查、对象遍历等场景中，它比for-in更简洁，也比Object.getOwnPropertyNames更聚焦。只要留意它对null、undefined以及Symbol和不可枚举属性的边界处理，就能在代码中放心使用。
Object.keysJavaScript对象遍历枚举属性修改时间：2026-08-08 20:42:31