合成一个完整的代码并且加上注释

为了演示如何合成一个简单的Python代码，并添加注释，我们将创建一个计算阶乘的函数。阶乘是一个数学概念，表示一个正整数n的所有小于等于它的正整数相乘的结果。例如，5的阶乘是5*4*3*2*1=120。

# 定义一个名为 factorial 的函数，接收一个参数 n，表示要计算阶乘的数
def factorial(n): 
    """
    计算给定数字n的阶乘。阶乘是指所有小于或等于n的正整数的乘积。

    参数:
    n (int): 需要计算阶乘的整数

    返回值:
    int: n的阶乘
    """
    
    # 初始阶乘为1，因为任何数的0次方都为1
    fact = 1
    
    # 如果n大于0，从1开始，一直乘到n
    if n > 0:
        for i in range(1, n+1):
            fact *= i  # 更新阶乘
    else:
        print("输入的数值必须是非负整数")

    # 返回计算得到的阶乘
    return fact


# 测试函数，计算5的阶乘
print(factorial(5))  # 输出: 120

这个代码首先定义了一个函数，然后解释了函数的作用、参数和返回值。接着，我们使用for循环实现了阶乘的计算过程，并对输入进行了检查。最后，通过调用函数并打印结果，展示了如何使用这个函数。