python必背源代码带默认参数函数代码

def format_greeting(name, title="同学", prefix="你好"):
    """
    基础必背函数：演示位置必选参数与多默认参数的组合使用
    :param name: 必选位置参数，无默认值
    :param title: 默认参数，默认称谓为 "同学"
    :param prefix: 默认参数，默认问候语为 "你好"
    :return: 拼接后的问候文本
    """
    return f"{prefix}，{name}{title}！"

# 示例调用场景 1：完全使用默认参数（仅传必选参数）
result1 = format_greeting("张三")
# 示例输出: '你好，张三同学！'

# 示例调用场景 2：按位置顺序覆盖第一个默认参数
result2 = format_greeting("李四", "工程师")
# 示例输出: '你好，李四工程师！'

# 示例调用场景 3：使用关键字传参，跳过中间参数直接覆盖指定参数
result3 = format_greeting("王五", prefix="早上好")
# 示例输出: '早上好，王五同学！'

def calculate_order_total(unit_price, quantity, discount_rate=0.0, tax_rate=0.05):
    """
    计算订单结算金额的标准数学公式函数
    :param unit_price: 单价（必填）
    :param quantity: 购买数量（必填）
    :param discount_rate: 折扣率，默认为 0.0（不打折）
    :param tax_rate: 税率，默认为 0.05（5% 增值税）
    :return: 最终应付金额（四舍五入保留两位小数）
    """
    subtotal = unit_price * quantity
    discounted = subtotal * (1.0 - discount_rate)
    final_total = discounted * (1.0 + tax_rate)
    return round(final_total, 2)

# 示例调用 A：常规无折扣购买（只传必选参数）
print(calculate_order_total(100.0, 2))
# 示例输出: 210.0

# 示例调用 B：八折促销活动（覆盖 discount_rate，tax_rate 沿用默认）
print(calculate_order_total(100.0, 2, discount_rate=0.2))
# 示例输出: 168.0

# 示例调用 C：免税且九折（同时覆盖两个默认参数）
print(calculate_order_total(100.0, 2, 0.1, 0.0))
# 示例输出: 180.0

# --------------------- 错误写法（严禁在生产中使用） ---------------------
def bad_append(item, target_list=[]):
    target_list.append(item)
    return target_list

print(bad_append("A"))  # 示例输出: ['A']
print(bad_append("B"))  # 示例输出: ['A', 'B']  <-- 致命错误：状态被意外累加残留！

# --------------------- 正确写法：必背安全防御初始化模板 ---------------------
def safe_append(item, target_list=None):
    """
    必背安全模板：使用不可变对象 None 作为占位哨兵
    在函数体内进行动态惰性初始化
    """
    if target_list is None:
        target_list = []  # 每次进入函数调用时，按需独立创建全新的内存对象
    target_list.append(item)
    return target_list

print(safe_append("A"))  # 示例输出: ['A']
print(safe_append("B"))  # 示例输出: ['B']  <-- 正常独立！

# 传入外部显式列表时同样完美兼容
my_tasks = ["init"]
print(safe_append("run", my_tasks))  # 示例输出: ['init', 'run']

def fetch_remote_data(
    endpoint,
    timeout=10,
    max_retries=3,
    use_cache=True,
    extra_headers=None,
    allowed_statuses=(200, 201)
):
    """
    工业级网络请求/接口交互标准默认参数函数模板
    :param endpoint: 目标 API 路径（必选位置参数）
    :param timeout: 超时秒数，默认 10 秒（不可变数字）
    :param max_retries: 最大重试次数，默认 3 次（不可变数字）
    :param use_cache: 是否启用缓存，默认开启（不可变布尔值）
    :param extra_headers: 附加请求头字典，默认 None（安全可变容器）
    :param allowed_statuses: 允许的正常状态码集合，默认 (200, 201)（不可变元组）
    :return: 组装好的配置上下文字典
    """
    # 1. 对 None 哨兵的容器参数实施安全初始化
    if extra_headers is None:
        headers = {"User-Agent": "PythonClient/1.0"}
    else:
        headers = dict(extra_headers)  # 浅拷贝保护，避免修改调用方原始对象

    # 2. 构造请求上下文并返回（模拟执行结果）
    config_summary = {
        "url": endpoint,
        "timeout_sec": timeout,
        "retry_limit": max_retries,
        "caching": use_cache,
        "headers": headers,
        "valid_codes": allowed_statuses
    }
    return config_summary

# 场景 1：基础轻量调用（仅提供 endpoint，其余全部按默认运行）
conf1 = fetch_remote_data("/api/v1/user/profile")

# 场景 2：针对大批量接口提高重试次数与超时限制
conf2 = fetch_remote_data(
    "/api/v1/batch/export",
    timeout=60,
    max_retries=5,
    use_cache=False
)

# 场景 3：附加专属授权 Token
conf3 = fetch_remote_data(
    "/api/v1/finance/ledger",
    extra_headers={"Authorization": "Bearer token_xyz"}
)