写一段代码并注释一下

下面是一个简单的Python代码示例，它演示了如何计算一个列表中数字的平均值：

# 定义一个函数average()，接受一个列表参数（numbers）
def average(numbers):
    """
    计算给定数字列表的平均值。
    
    参数:
    numbers (list): 包含整数或浮点数的列表
    
    返回:
    float: 列表元素的平均值
    """
    # 检查输入是否为空
    if not numbers:
        return "Error: List is empty."

    # 使用内置sum()函数计算列表元素总和
    total = sum(numbers)

    # 计算平均值（总和除以元素数量）
    avg = total / len(numbers)
    
    return avg

# 测试函数，传入一个包含数字的列表
test_list = [1, 2, 3, 4, 5]
result = average(test_list)

# 打印结果
print(f"平均值为: {result}")

在这个例子中，我们定义了一个名为`average`的函数，它接收一个数字列表作为输入，计算列表元素的总和，然后除以元素的数量得到平均值。如果列表为空，函数会返回一个错误消息。最后，我们创建了一个测试列表，并将其传递给函数，打印出计算得到的平均值。