详细介绍JavaScript对象数组按指定属性排序的方法,涵盖数值属性、中英文字符串属性、日期属性、多字段组合排序、null与undefined空值处理,以及sort原位排序与toSorted不可变排序的适用场景与完整代码示例。
JavaScript对象数组按指定属性排序的方法
时间:2026-11-18
浏览:542
文章目录
在 JavaScript 中,对对象数组按指定属性排序,核心做法是向数组的 sort() 或 toSorted() 方法传入一个自定义比较函数 (a, b) => ...,在函数内部读取两个对象的目标属性并返回比较结果。由于对象的属性可能是数字、英文字符串、中文字符串、日期字符串或可能包含空值,不同数据类型需要配合对应的比较表达式,才能得到准确的升序或降序结果。
假设你正在处理一份商城商品列表数据,每个商品都是一个包含名称 name、价格 price、上架日期 createdAt 和库存 stock 的对象。当用户在页面上点击“按价格从低到高”或“按名称首字母排序”时,如果不提供比较函数而直接调用 products.sort(),JavaScript 会把每个对象转换成字符串 "[object Object]" 再比较,导致数组顺序毫无变化。下面结合这套统一的示例数据,逐一说明按各类属性排序的具体写法与注意事项。
一、比较函数的工作原理与基础示例数据
Array.prototype.sort(compareFn) 接收一个带有两个参数 a 和 b 的回调函数,分别代表数组中正在比较的两个对象元素。排序引擎根据回调函数的返回值正负来决定谁排在前面:
- 返回值 小于 0:
a排在b前面。 - 返回值 大于 0:
b排在a前面。 - 返回值 等于 0:保持
a和b原有的相对位置不变(自 ECMAScript 2019 起,规范要求sort()必须为稳定排序)。
以下代码可在浏览器开发者工具控制台(Console)或 Node.js 环境(建议 Node.js 20 及以上版本以支持全部现代数组方法)中直接运行。我们先定义后续各小节共用的商品数组 products:
const products = [
{ id: 1, code: "kb-02", name: "机械键盘", price: 299, stock: 15, createdAt: "2026-03-12" },
{ id: 2, code: "ms-01", name: "无线鼠标", price: 89, stock: 40, createdAt: "2026-01-20" },
{ id: 3, code: "hd-05", name: "降噪耳机", price: 599, stock: 15, createdAt: "2026-02-05" },
{ id: 4, code: "st-03", name: "显示器支架", price: 159, stock: 28, createdAt: "2026-03-01" }
];
二、按数值属性排序(升序与降序)
当目标属性是数字类型(如价格 price、库存 stock、年龄 age)时,最简洁可靠的做法是直接在比较函数中将两个对象的属性值相减:
- 升序(从小到大):使用
a.price - b.price。当a.price小于b.price时,差值为负数,a排在前面。 - 降序(从大到小):使用
b.price - a.price。当b.price大于a.price时,差值为正数,b排在前面。
// 按 price 升序排序(使用展开运算符浅拷贝数组,避免覆盖原数组顺序)
const ascByPrice = [...products].sort((a, b) => a.price - b.price);
console.log(ascByPrice.map(item => `${item.name}: ${item.price}`));
// 按 price 降序排序
const descByPrice = [...products].sort((a, b) => b.price - a.price);
console.log(descByPrice.map(item => `${item.name}: ${item.price}`));
1. 切勿在比较函数中写成
(a, b) => a.price > b.price。在 JavaScript 中,比较运算符返回的是布尔值 true 或 false,而不是正负数,这会导致部分引擎无法正确排列顺序。
2. 如果后端接口返回的数字属性被存成了字符串(例如
"89" 和 "159"),减法运算符 a.price - b.price 会自动触发隐式数值转换;但为了代码可读性与安全性,建议显式写成 Number(a.price) - Number(b.price)。
三、按字符串属性排序(英文与中文)
字符串属性不能使用减法运算符(两个字符串相减会得到 NaN)。按字符串属性排序应当使用字符串原生的 localeCompare() 方法,它正好返回负数、0 或正数,符合 sort() 的返回值要求。
1. 英文与混合编号字符串排序
对于英文字母或编号属性(如 code),直接调用 a.code.localeCompare(b.code) 即可按字典序升序排列。如果字符串中带有数字编号(如 "item-2" 和 "item-10"),建议传入配置项 { numeric: true, sensitivity: "base" },这样能让 "item-2" 排在 "item-10" 前面,并且忽略字母大小写差异:
// 按 code 属性升序排序(忽略大小写并识别数字编号)
const sortedByCode = [...products].sort((a, b) =>
a.code.localeCompare(b.code, "en", { numeric: true, sensitivity: "base" })
);
console.log(sortedByCode.map(item => item.code));
2. 中文字符串按拼音排序
如果对中文字符串直接使用 < 或 > 比较,JavaScript 会按照字符的 Unicode 码点排序,结果既不是拼音顺序也不是笔画顺序。要按汉语拼音字典序排列,需要为 localeCompare 指定语言环境参数 "zh-CN"(或 "zh-Hans-CN")。当数组元素较多(例如上千条记录)时,预先创建一个 Intl.Collator 实例再传入 sort(),比每次比较都解析一次语言配置更快:
// 创建中文拼音比较器实例
const zhCollator = new Intl.Collator("zh-CN", { sensitivity: "accent" });
// 按中文名称拼音升序排序:机械键盘(J) -> 降噪耳机(J) -> 无线鼠标(W) -> 显示器支架(X)
const sortedByName = [...products].sort((a, b) => zhCollator.compare(a.name, b.name));
console.log(sortedByName.map(item => item.name));
"zh-CN" 拼音排序;若在极简裁剪版嵌入式运行时中执行,排序顺序可能会退化为 Unicode 码点顺序。
四、按日期时间属性排序
对象中的日期属性常见有两种格式:标准 ISO 格式字符串(如 "2026-03-12")或完整的日期时间字符串。通用的做法是使用 Date.parse() 或 new Date(val).getTime() 将日期转换为毫秒级时间戳,再按照数值属性相减的方式排序:
// 按 createdAt 从早到晚(升序)排序
const sortedByDateAsc = [...products].sort(
(a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt)
);
console.log(sortedByDateAsc.map(item => `${item.createdAt} (${item.name})`));
// 按 createdAt 从晚到早(降序,最新在前)排序
const sortedByDateDesc = [...products].sort(
(a, b) => Date.parse(b.createdAt) - Date.parse(a.createdAt)
);
console.log(sortedByDateDesc.map(item => `${item.createdAt} (${item.name})`));
五、多属性组合排序与空值(null / undefined)处理
实际业务中经常遇到两个进阶需求:一是当第一属性相同时按第二属性继续排序(例如库存相同时,按价格从低到高排);二是部分对象的属性值为 null 或 undefined,需要将这些缺失值统一固定排在数组末尾。
1. 多属性组合排序
在 JavaScript 中,数值 0 在逻辑运算中会被视为假值(falsy)。因此,当第一属性的比较结果为 0(即两个对象的主属性值相等)时,使用逻辑或运算符 || 会自动向右执行第二属性的比较表达式:
// 先按库存 stock 升序;当 stock 相同时(如机械键盘和降噪耳机都是 15),再按 price 升序
const multiSorted = [...products].sort(
(a, b) => (a.stock - b.stock) || (a.price - b.price)
);
console.log(multiSorted.map(item => `${item.name}(库存:${item.stock}, 价格:${item.price})`));
2. 包含 null、undefined 或嵌套属性的排序
如果对象中的排序字段可能为 null 或 undefined,直接相减会导致 null 被转换成 0,或者 undefined 产生 NaN 导致排序混乱。应当在比较函数开头先判断空值,将其固定排在末尾:
const itemsWithNull = [
{ name: "商品A", discountPrice: 120 },
{ name: "商品B", discountPrice: null },
{ name: "商品C", discountPrice: 85 },
{ name: "商品D", discountPrice: undefined }
];
// 升序排序,但将 null 和 undefined 统一排在最后
const safeSorted = [...itemsWithNull].sort((a, b) => {
const valA = a.discountPrice;
const valB = b.discountPrice;
if (valA == null && valB == null) return 0;
if (valA == null) return 1; // a 为空,排在 b 后面
if (valB == null) return -1; // b 为空,a 排在 b 前面
return valA - valB;
});
console.log(safeSorted);
六、不修改原数组的排序:toSorted() 与通用排序工具函数
Array.prototype.sort() 会直接修改原数组(原位排序)并返回原数组的引用。在 React、Vue 等前端框架中,直接调用 stateArray.sort() 会改变原状态引用,常导致视图不触发重新渲染或产生意外副作用。
ECMAScript 2023 新增了 Array.prototype.toSorted(compareFn) 方法,它的参数规则与 sort() 完全一致,但不会修改原数组,而是返回一个排序后的新数组(需 Chrome 110+、Safari 16+、Firefox 115+ 或 Node.js 20+)。如果需要兼容更早的运行环境,使用 [...arr].sort(compareFn) 或 arr.slice().sort(compareFn) 即可达到同样效果。
为了在项目中复用排序逻辑,可以封装一个支持指定属性名、排序方向与空值沉底的通用函数 sortByProperty:
/**
* 按指定属性对对象数组排序(返回新数组,不修改原数组)
* @param {Array<Object>} array 待排序的对象数组
* @param {string} key 排序属性名
* @param {"asc" | "desc"} order 升序 "asc" 或降序 "desc"
*/
function sortByProperty(array, key, order = "asc") {
const factor = order === "desc" ? -1 : 1;
return [...array].sort((a, b) => {
const valA = a?.[key];
const valB = b?.[key];
// 空值始终排在末尾,不受升序/降序影响
if (valA == null && valB == null) return 0;
if (valA == null) return 1;
if (valB == null) return -1;
if (typeof valA === "number" && typeof valB === "number") {
return (valA - valB) * factor;
}
return String(valA).localeCompare(String(valB), "zh-CN", { numeric: true }) * factor;
});
}
// 调用示例:按价格降序生成新数组
const result = sortByProperty(products, "price", "desc");
console.log("排序结果首项:", result[0].name, result[0].price);
console.log("原数组首项未变:", products[0].name, products[0].price);
七、方法总结与常见场景速查
下图与表格汇总了 JavaScript 对象数组按指定属性排序的全部核心写法与适用边界,便于在实际开发中快速对照选用。
| 排序场景 | 推荐比较函数写法(以升序为例) | 降序调整方式 |
|---|---|---|
数字属性(price) |
(a, b) => a.price - b.price |
改为 b.price - a.price |
英文/编号属性(code) |
(a, b) => a.code.localeCompare(b.code, "en", { numeric: true }) |
交换 a 和 b 的调用位置 |
中文属性按拼音(name) |
(a, b) => a.name.localeCompare(b.name, "zh-CN") |
交换 a 和 b 的调用位置 |
日期字符串(createdAt) |
(a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt) |
改为 Date.parse(b.createdAt) - Date.parse(a.createdAt) |
多属性组合(先 stock 后 price) |
(a, b) => (a.stock - b.stock) || (a.price - b.price) |
按各字段需求分别调整 a、b 顺序 |
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。