如何自定义Python函数必填参数缺失时的TypeError错误信息？

当然可行，下面是几种实用的实现方案，按需选择：

方案一：单个函数内直接检查（简单场景） #

给必填参数设置一个哨兵默认值，在函数开头判断是否未传入，手动抛出带自定义信息的TypeError：

def f(a=None):
    # 若参数允许传入None，可替换为更独特的哨兵值如sentinel = object()
    if a is None:
        raise TypeError("f() missing 1 required positional argument: 'a' (参数a为必填项，用于传递整数类型的ID值，示例：f(100))")
    print('a的值:', a)

# 测试调用
f()

运行后会抛出自定义错误：

TypeError: f() missing 1 required positional argument: 'a' (参数a为必填项，用于传递整数类型的ID值，示例：f(100))

方案二：装饰器复用检查逻辑（多函数场景） #

如果多个函数都需要自定义错误信息，用装饰器可以统一处理，避免重复代码：

import inspect

def custom_required_error(descriptions):
    """
    生成自定义必填参数错误的装饰器
    :param descriptions: 字典，键为参数名，值为参数说明
    """
    def decorator(func):
        sig = inspect.signature(func)
        params = sig.parameters

        def wrapper(*args, **kwargs):
            # 筛选出必填的位置/关键字参数
            required_params = [
                name for name, param in params.items()
                if param.default is inspect.Parameter.empty
                and param.kind not in (inspect.Parameter.VAR_POSITIONAL, inspect.Parameter.VAR_KEYWORD)
            ]
            # 统计已传入的位置参数数量
            given_pos = len(args)
            # 找出缺失的必填参数（排除已通过关键字传入的）
            missing = [p for p in required_params[given_pos:] if p not in kwargs]
            
            if missing:
                # 拼接自定义错误信息
                base_msg = f"{func.__name__}() missing {len(missing)} required positional argument{'s' if len(missing)>1 else ''}: {', '.join(missing)}"
                desc_msg = "\n参数说明:\n" + "\n".join([f"  - {p}: {descriptions.get(p, '无详细说明')}" for p in missing])
                raise TypeError(base_msg + desc_msg)
            return func(*args, **kwargs)
        return wrapper
    return decorator

# 使用装饰器，传入参数说明
@custom_required_error({
    'a': '必填参数，用于用户ID，需为正整数',
    'b': '必填参数，用于用户名，需为非空字符串'
})
def f(a, b):
    print(f"用户ID: {a}, 用户名: {b}")

# 测试调用
f()

运行后错误信息如下：

TypeError: f() missing 2 required positional arguments: a, b
参数说明:
  - a: 必填参数，用于用户ID，需为正整数
  - b: 必填参数，用于用户名，需为非空字符串

注意事项 #

• 不建议直接修改Python内置的TypeError抛出逻辑，这会影响全局所有代码的错误行为，风险极高。
• 如果参数允许传入None，要换用更独特的哨兵值（比如sentinel = object()），避免误判。

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