问题背景 #

你有一个调用API获取数据的函数，原本的实现是固定查询参数，现在想要改造成支持通过**kwargs传入自定义参数，同时每个参数都带有默认值：

• 可指定.During()的时间范围，不传则默认用Yesterday
• 可指定.Select()的字段列表，不传则默认用Date和SearchEngine
• 下载报告的参数也需支持自定义，默认沿用原函数的配置

之前尝试的实现在无参调用时会触发KeyError，因为直接通过kwargs['key']取值，没有处理默认值的情况。

解决方案 #

要实现这个需求，核心是用kwargs.get(key, default)的方式获取参数（或者给函数参数设置默认值），这样在没有传入对应参数时会自动使用预设的默认值，避免KeyError。另外要注意.Select()需要接受多个位置参数，所以如果传入的是列表，需要用*解包。

下面是完整的实现代码：

def foo(**kwargs):
    # 从kwargs中获取参数，没有传入则使用默认值
    # 注意：如果client是必须依赖的实例，你可以把它设为位置参数，或者在这里指定一个默认的client实例
    client = kwargs.get('client', your_default_client)  # 替换your_default_client为实际的默认客户端实例
    select_fields = kwargs.get('select', ['Date', 'SearchEngine'])
    report_type = kwargs.get('report_type', 'Report_10')
    during_period = kwargs.get('during', 'Yesterday')
    
    # 下载报告的参数默认值
    skip_header = kwargs.get('skip_header', True)
    include_names = kwargs.get('include_names', False)
    get_summary = kwargs.get('get_summary', True)
    get_totals = kwargs.get('get_totals', False)

    # 构建查询：用*解包select_fields，把列表元素转为Select的位置参数
    report_query = (client.buildQuery()
                   .Select(*select_fields)
                   .From(report_type)
                   .During(during_period))
    
    # 执行报告下载
    get_report.downloadReport(
        skip_header=skip_header, include_names=include_names,
        get_summary=get_summary, get_totals=get_totals)

关键细节说明 #

1. 避免KeyError：使用kwargs.get()替代直接索引kwargs[key]，当字典中没有对应key时，会返回你指定的默认值，而不是抛出异常。
2. 处理Select的字段：.Select()方法接受多个单独的字段名作为参数，所以需要用*select_fields把列表解包成多个位置参数，否则会把整个列表当作一个参数传入，导致API调用出错。
3. 灵活的参数覆盖：你可以只传入需要自定义的参数，其他参数自动使用默认值，比如：

   # 只自定义时间范围和选择字段
   foo(client=my_client, select=['Date', 'Device', 'StrategyType'], during='Last7Days')
   

4. 无参调用：直接调用foo()时，所有参数都会使用默认值，和你最初的函数行为完全一致。

内容的提问来源于stack exchange，提问作者Jonas Palačionis