Python：调用传关键字参数时，如何规避Mock方法参数不匹配问题？

问题背景 #

原类方法定义：

def method(self, keyarg1, keyarg2):
    # 方法实现

调用时固定使用关键字参数传递：

class_instance.method(keyarg1=..., keyarg2=...)

尝试用_和__作为参数名定义Mock类时，会因为参数名不匹配调用的关键字参数而报错；如果直接定义同名参数，又会触发代码检查工具（linter）的未使用参数错误，希望找到无需手动屏蔽linter的规范解决方式。

规范解决方法 #

1. 用**kwargs收集关键字参数

直接在Mock方法里定义**_kwargs（下划线前缀表示有意忽略的参数）接收所有关键字参数，既匹配调用方式，又不会触发linter的未使用参数警告：

class MockedClass:
    def method(self, **_kwargs):
        # Mock实现，无需处理传入的参数

多数linter默认不会对带下划线前缀的**_kwargs报错，因为下划线是Python中表示“未使用参数”的惯例。

2. 用*args + **kwargs兼容所有参数传递

如果需要兼容原方法可能的位置参数调用，这种方式更通用，完全适配任何参数传递形式：

class MockedClass:
    def method(self, *_args, **_kwargs):
        # Mock实现

同样，下划线前缀的参数名会被linter识别为“有意忽略的参数”，避免报错。

3. 使用unittest.mock的内置Mock类

Python标准库的unittest.mock提供的Mock类天生支持接收任意参数，完全不用手动定义参数列表，适合测试场景：

from unittest.mock import Mock

# 直接创建Mock实例替代原类
mocked_instance = Mock()
# 或者自定义Mock类继承Mock
class MockedClass(Mock):
    pass

调用mocked_instance.method(keyarg1=..., keyarg2=...)不会有任何报错，还能利用Mock类的断言、调用记录等功能。

4. 类型忽略注释（备选）

如果一定要显式定义参数，可给参数行加# type: ignore注释跳过linter检查，但这种方式不如前几种规范：

class MockedClass:
    def method(self, keyarg1, keyarg2):  # type: ignore
        # Mock实现

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