JavaScript对象数组按指定属性排序的方法

作者:拾光

时间:2026-11-18

浏览:542

详细介绍JavaScript对象数组按指定属性排序的方法,涵盖数值属性、中英文字符串属性、日期属性、多字段组合排序、null与undefined空值处理,以及sort原位排序与toSorted不可变排序的适用场景与完整代码示例。

文章目录

在 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() 必须为稳定排序)。
JavaScript对象数组按指定属性排序的方法
图 1:compareFn(a, b) 返回值符号与数组元素排列顺序的对应关系

以下代码可在浏览器开发者工具控制台(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}`));
示例输出:[ '无线鼠标: 89', '显示器支架: 159', '机械键盘: 299', '降噪耳机: 599' ] [ '降噪耳机: 599', '机械键盘: 299', '显示器支架: 159', '无线鼠标: 89' ]
容易出错的地方:
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() 的返回值要求。

JavaScript对象数组按指定属性排序的方法
图 2:根据目标属性类型选择排序表达式的操作步骤

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));
示例输出:[ 'hd-05', 'kb-02', 'ms-01', 'st-03' ]

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));
示例输出:[ '机械键盘', '降噪耳机', '无线鼠标', '显示器支架' ]
运行环境说明:按中文拼音排序依赖宿主环境(浏览器或 Node.js)内置的 ICU 国际化数据包。现代主流浏览器与默认编译完整 ICU 的 Node.js 版本均支持 "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})`));
示例输出:[ '2026-01-20 (无线鼠标)', '2026-02-05 (降噪耳机)', '2026-03-01 (显示器支架)', '2026-03-12 (机械键盘)' ] [ '2026-03-12 (机械键盘)', '2026-03-01 (显示器支架)', '2026-02-05 (降噪耳机)', '2026-01-20 (无线鼠标)' ]

五、多属性组合排序与空值(null / undefined)处理

实际业务中经常遇到两个进阶需求:一是当第一属性相同时按第二属性继续排序(例如库存相同时,按价格从低到高排);二是部分对象的属性值为 null 或 undefined,需要将这些缺失值统一固定排在数组末尾。

JavaScript对象数组按指定属性排序的方法
图 3:利用逻辑或(||)短路特性实现多属性串联排序与空值前置检查

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})`));
示例输出:[ '机械键盘(库存:15, 价格:299)', '降噪耳机(库存:15, 价格:599)', '显示器支架(库存:28, 价格:159)', '无线鼠标(库存:40, 价格:89)' ]

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);
示例输出:[ { name: '商品C', discountPrice: 85 }, { name: '商品A', discountPrice: 120 }, { name: '商品B', discountPrice: null }, { name: '商品D', discountPrice: undefined } ]

六、不修改原数组的排序: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);
示例输出:排序结果首项: 降噪耳机 599 原数组首项未变: 机械键盘 299

七、方法总结与常见场景速查

下图与表格汇总了 JavaScript 对象数组按指定属性排序的全部核心写法与适用边界,便于在实际开发中快速对照选用。

JavaScript对象数组按指定属性排序的方法
图 4: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 顺序

实用工具推荐

电子包浆

绿化、压缩、噪点和虚拟水印,自由调节做旧程度。

使用 ›
图片压缩

选择画质和输出格式,预览压缩前后的大小。

使用 ›
相关文章