代码整洁之道示例：优化 Python 代码可读性和可维护性

本文通过一个简单的 Python 代码示例展示了如何使用代码整洁之道来改善代码可读性和可维护性。

原始代码：

def calculate_sum(lst):
    result = 0
    for i in range(len(lst)):
        if lst[i] > 0:
            result += lst[i]
    return result

改进后的代码：

def calculate_sum(lst):
    result = 0
    for num in lst:
        if num > 0:
            result += num
    return result

改进后的代码使用更加清晰的变量名和更简洁的语法，使得代码更容易理解。同时，我们还可以使用类型提示和注释来进一步提高代码的可读性和可维护性：

from typing import List

def calculate_sum(lst: List[int]) -> int:
    '''
    计算列表中所有正整数的和。
    '''
    result = 0
    for num in lst:
        if num > 0:
            result += num
    return result

这个版本的代码使用了类型提示来明确参数和返回值的类型，同时添加了注释来解释函数的作用。这使得代码更加易于理解和维护。