HOWTO · JavaScript

在 JavaScript 中计算中位数

本 JavaScript 教程解释了中位数是什么以及如何在值列表中找到它。

本页内容

中位数是数字按升序排列后的中间值,它将有序数据集分成较低和较高的两半。JavaScript 没有内置的中位数方法,因此可以编写一个小函数,对数值排序并选出中间值。本指南处理由有限数值组成的数组;如果输入不符合这一约定,函数会返回 null。

中位数的含义

当数值个数为奇数时,中间有一个值;当数值个数为偶数时,中间位置落在两个值之间,因此中位数是这两个值的算术平均数。例如,将 [3, 1, 4, 2] 排序后得到 [1, 2, 3, 4];其中位数为 (2 + 3) / 2,即 2.5。必须进行数值排序:JavaScript 默认的 sort() 会把值当作字符串比较,因此可能把 12 排在 3 前面。传入 (a, b) => a - b 可按数值升序排列。

实现中位数函数

此函数适用于由有限数值组成的数组。它会先排序副本,因此传入的数组仍保持原有顺序。

运行以下示例:

本节中的代码以及显示的标签或输出仍为英文。

function calculateMedian(values) {
  if (!Array.isArray(values) || values.length === 0) return null;
  for (let i = 0; i < values.length; i++) {
    if (!Object.prototype.hasOwnProperty.call(values, i) ||
        typeof values[i] !== "number" || !Number.isFinite(values[i])) {
      return null;
    }
  }

  const sorted = [...values].sort((a, b) => a - b);
  const middle = Math.floor(sorted.length / 2);
  return sorted.length % 2 === 1
    ? sorted[middle]
    : (sorted[middle - 1] + sorted[middle]) / 2;
}

console.log(calculateMedian([7, 1, 5, 3]));
console.log(calculateMedian([8, 2, 6, 4, 10]));
4
6

第一次调用使用四个值,因此函数会计算两个中间值的平均数;第二次调用使用五个值,因此会返回唯一的中间值。这两次调用的观测输出依次为 4 和 6。只有当非空数组的每个索引都对应其自身的有限数值时,函数才接受该数组。

选择是否修改输入

Array.prototype.sort() 会重排被调用的数组。修改调用方的数据可能影响后续计算、渲染,或依赖原始顺序的比较。上面的函数使用 [...values] 在排序前创建浅拷贝;因此,[...values].sort((a, b) => a - b) 不会改变调用方的数组。对于原始数值,浅拷贝已经足够。如果你确实想就地重排数组,可以直接对该数组排序,并向调用方说明这一副作用。

处理空输入和无效输入

对于非数组、空数组,或包含非有限数值的数组,函数会返回 null。它会拒绝整个输入,而不是筛除无效值:悄悄丢弃字符串或 null 可能改变所汇总的数据;筛除后也可能没有值可供选择。Number.isFinite() 会排除 NaN、Infinity 和 -Infinity;typeof 检查也会排除看起来像数值的字符串。调用方可以检查是否得到 null,再决定显示提示、跳过计算,或提前验证源数据。如果应用需要采用其他策略,例如筛除无效记录,应明确作出选择,并在求中间值前确认至少还剩一个可用数值。

理解性能与局限

排序是主要开销;对于 n 个值,通常需要 O(n log n) 次比较。复制数组会额外使用 O(n) 空间;就地排序可以避免这次复制,但会改变输入。对于非常大的数据集,反复完整排序可能代价很高,可以考虑选择算法或适合该工作负载的统计库。简单平均值 (a + b) / 2 对两个非常大的有限值可能发生溢出;如果数据中可能出现这种量级,应选择并说明数值上更安全的平均值算法,并针对应用的数值范围进行测试。