def add(a, b):
    """計(jì)算兩個(gè)數(shù)的和"""
    return a + b

# 查看函數(shù)備注的方法
print(add.__doc__)  # 輸出：計(jì)算兩個(gè)數(shù)的和
help(add)  # 更友好的交互式查看，會(huì)顯示函數(shù)簽名+備注

def calculate_area(shape: str, width: float, height: float = None) -> float:
    """
    計(jì)算常見幾何圖形的面積。

    支持的圖形：矩形（rectangle）、三角形（triangle）
    
    Args:
        shape: 圖形類型，可選值為 "rectangle" 或 "triangle"
        width: 寬度/底邊長(zhǎng)（浮點(diǎn)型）
        height: 高度（浮點(diǎn)型），矩形可不傳（默認(rèn)等于width，即正方形）
    
    Returns:
        計(jì)算出的面積（浮點(diǎn)型）
    
    Raises:
        ValueError: 當(dāng)shape不是指定值，或?qū)?高為負(fù)數(shù)時(shí)拋出
    """
    if width < 0 or (height and height < 0):
        raise ValueError("寬/高不能為負(fù)數(shù)")
    
    if shape == "rectangle":
        height = height or width  # 未傳height時(shí)默認(rèn)正方形
        return width * height
    elif shape == "triangle":
        if not height:
            raise ValueError("三角形必須傳入height")
        return 0.5 * width * height
    else:
        raise ValueError(f"不支持的圖形類型：{shape}")

# 查看備注
help(calculate_area)

def calculate_area(shape: str, width: float, height: float = None) -> float:
    """
    計(jì)算常見幾何圖形的面積。

    :param shape: 圖形類型，可選值為 "rectangle" 或 "triangle"
    :type shape: str
    :param width: 寬度/底邊長(zhǎng)（浮點(diǎn)型）
    :type width: float
    :param height: 高度（浮點(diǎn)型），矩形可不傳（默認(rèn)等于width）
    :type height: float
    :return: 計(jì)算出的面積
    :rtype: float
    :raises ValueError: 當(dāng)shape非法或?qū)?高為負(fù)時(shí)拋出
    """
    # 邏輯和上面一致（省略）
    pass