编辑“︁代码审查”︁（章节）

== 代码示例 ==
以下是一个需要审查的Python函数示例：

<syntaxhighlight lang="python">
def calculate_average(numbers):
    """
    计算数字列表的平均值
    
    参数:
        numbers (list): 数字列表
        
    返回:
        float: 平均值
    """
    if not numbers:
        return 0
    total = 0
    for num in numbers:
        total += num
    return total / len(numbers)
</syntaxhighlight>

'''审查意见'''：
1. 应考虑使用内置sum()函数提高可读性
2. 空列表返回0可能不是最佳处理方式
3. 可添加类型提示增强代码清晰度

改进版本：
<syntaxhighlight lang="python">
from typing import List

def calculate_average(numbers: List[float]) -> float:
    """
    计算数字列表的平均值
    
    参数:
        numbers: 包含浮点数的列表
        
    返回:
        列表的平均值
        
    异常:
        ValueError: 当输入为空列表时抛出
    """
    if not numbers:
        raise ValueError("输入列表不能为空")
    return sum(numbers) / len(numbers)
</syntaxhighlight>