```python def calculate_average(numbers): """计算一个数字列表的平均值。

Args: numbers: 一个数字列表。

Returns: 数字列表的平均值。

Raises: ValueError: 如果输入列表为空。 """ if not numbers: raise ValueError("输入列表不能为空") return sum(numbers) / len(numbers)

示例用法

numbers = [1, 2, 3, 4, 5] average = calculate_average(numbers) print(f"数字列表的平均值是: {average}") ```

文档字符串

此代码包含一个名为 calculate_average 的函数，该函数计算一个数字列表的平均值。该函数的文档字符串包含以下信息：

• 函数的用途
• 参数
• 返回值
• 异常

示例用法

代码还包含一个示例用法，演示如何使用 calculate_average 函数。

Markdown 格式

此代码以 Markdown 格式编写，使之易于阅读和理解。