计算列表中的数字平均值 - JavaScript

在JavaScript中，我们可以编写一个函数来计算给定数字列表中的平均值。以下是一个示例函数：

/**
 * 计算数字列表的平均值
 * @param {Array} numbers 数字列表
 * @returns {number} 平均值
 */
function calculateAverage(numbers) {
  // 确保输入为数组类型
  if (!Array.isArray(numbers)) {
    throw new Error('输入必须是数组类型');
  }

  // 确保输入数组不为空
  if (numbers.length === 0) {
    throw new Error('输入数组不能为空');
  }

  // 计算列表中所有数字的总和
  const sum = numbers.reduce((acc, current) => acc + current, 0);

  // 计算平均值并返回
  const average = sum / numbers.length;
  return average;
}

// 示例用法
const numbers = [1, 2, 3, 4, 5];
const average = calculateAverage(numbers);
console.log(`数字列表的平均值为：${average}`);

在以上示例代码中，我们编写了一个名为 calculateAverage 的函数，该函数接受一个数字列表作为输入，并返回该列表的平均值。该函数首先检查输入是否为数组类型以及是否为空。然后，它使用 reduce 函数计算列表中所有数字的总和，并将其除以数字列表的长度，从而计算平均值。最后，平均值被返回并打印到控制台上。

此外，在该函数的注释中，我们还为该函数提供了一个JSDoc注释，以便其他程序员使用时能够清楚地了解该函数的使用方法和期望输入/输出参数。

希望这个简单的函数对你有所帮助，在需要时可以直接使用它来计算数字列表的平均值。