如何优化存在重复通用参数的Python函数调用签名与代码结构

首先最推荐优先使用dataclass封装通用参数集的方案，兼顾可读性、改造成本和可维护性，完全满足你跨层级批量传参的需求：

from dataclasses import dataclass
# 建议加frozen=True保证参数不可变，避免意外修改导致的隐蔽bug
@dataclass(frozen=True)
class StdArgs:
    std_arg1: int
    std_arg2: str
    std_arg3: float
    # 其他通用参数

使用方式完全符合你的预期：

# 上层一次性构造参数集
all_args = StdArgs(std_arg1=1, std_arg2="test", std_arg3=3.14)

def super_f(arg1, arg2, all_args: StdArgs):
    # 跨层级传递直接传对象即可，不需要拆包
    f3(arg2, all_args)

def f3(arg, all_args: StdArgs):
    # 内部使用直接取属性，有IDE补全、类型校验，写错直接提示
    if all_args.std_arg1 > 0:
        # 业务逻辑
        pass

这个方案的优势：

• 完全避免列表解包的顺序错误问题，也比字典的键值访问写法更简洁
• 支持类型提示，IDE可自动补全属性，参数写错会提前报错，不用等到运行时
• 传参仅传递对象引用，无额外性能损耗，效率远高于传大量零散参数
• 跨模块传递无需额外处理，所有依赖通用参数的函数统一接收StdArgs类型对象即可

如果你不想修改原有函数的签名，可使用functools.partial预绑定通用参数，零侵入适配原有代码：

from functools import partial

# 原有未修改的函数
def f1(arg, std_arg1, std_arg2, std_arg3):
    pass

# 上层一次性绑定通用参数
std_arg1, std_arg2, std_arg3 = 1, "test", 3.14
f1_bound = partial(f1, std_arg1=std_arg1, std_arg2=std_arg2, std_arg3=std_arg3)

# 后续调用仅需传入差异化参数
f1_bound(arg=10)

如果你的通用参数在整个业务流程中固定不变，还可以使用上下文管理器+装饰器的方案完全省略显式传参：

from contextlib import contextmanager
import inspect

# 全局存储当前流程的通用参数，线程隔离场景可替换为threading.local
_current_std_args = None

@contextmanager
def with_std_args(std_args: StdArgs):
    global _current_std_args
    prev = _current_std_args
    _current_std_args = std_args
    try:
        yield
    finally:
        _current_std_args = prev

# 给需要通用参数的函数加装饰器，自动注入参数
def inject_std_args(func):
    sig = inspect.signature(func)
    def wrapper(*args, **kwargs):
        for param_name in sig.parameters:
            if param_name in _current_std_args.__dict__ and param_name not in kwargs:
                kwargs[param_name] = getattr(_current_std_args, param_name)
        return func(*args, **kwargs)
    return wrapper

# 使用示例
@inject_std_args
def f1(arg, std_arg1, std_arg2):
    print(std_arg1, std_arg2)

with with_std_args(StdArgs(1, "test", 3.14)):
    # 无需传入通用参数，自动注入
    f1(arg=10)

• 列表解包：参数顺序容易出错，无类型提示，参数数量变化时维护成本极高，不推荐使用
• 字典存参数：无类型校验，键名拼写错误仅会在运行时报错，访问写法繁琐，远不如dataclass易用
• 全局变量：线程不安全，多流程并行时会出现参数串用问题，可维护性极差，完全不推荐
• 普通类实现：本质和dataclass方案一致，但手写__init__赋值成本高，self.前缀问题可通过上述partial或上下文管理器方案规避

内容的提问来源于stack exchange，提问作者Reddy