如何让Pylance识别函数继承自其他函数的关键字参数？

针对你遇到的问题，有两种可行的方式实现类型提示友好的参数复用，无需手动同步函数参数：

方案1：利用Python类型提示原生特性（推荐，Python 3.10+） #

使用ParamSpec定义源函数的参数规格，结合Unpack（Python 3.11+ 内置，低版本需从typing_extensions导入）直接标注**kwargs包含的参数，无需装饰器：

from typing import ParamSpec
from typing_extensions import Unpack  # Python 3.11+ 可替换为 from typing import Unpack

P = ParamSpec("P")

def a(*, a_arg1: str, a_arg2: int):
    ...  # 原函数逻辑

def b(*, b_arg1: str, **kwargs: Unpack[P]) -> None:
    a(**kwargs)

Pylance会识别Unpack[P]对应的参数，自动提供a_arg1、a_arg2的类型和必填提示。

方案2：自定义类型提示装饰器 #

如果需要装饰器形式的实现，可以写一个仅处理类型注解和签名的装饰器，不影响函数运行逻辑：

import inspect
from typing import Callable

def inherit_params(source_func: Callable) -> Callable:
    def decorator(target_func: Callable) -> Callable:
        # 提取源函数的关键字-only参数信息
        source_sig = inspect.signature(source_func)
        source_params = [p for p in source_sig.parameters.values() if p.kind == p.KEYWORD_ONLY]
        
        # 合并目标函数与源函数的参数签名
        target_sig = inspect.signature(target_func)
        new_params = list(target_sig.parameters.values()) + source_params
        target_func.__signature__ = target_sig.replace(parameters=new_params)
        
        # 合并参数注解
        target_func.__annotations__.update({p.name: p.annotation for p in source_params})
        return target_func
    return decorator

# 使用示例
def a(*, a_arg1: str, a_arg2: int):
    ...

@inherit_params(a)
def b(*, b_arg1: str, **kwargs):
    a(**kwargs)

这个装饰器会修改函数b的签名和注解元数据，Pylance读取后就能识别源函数a的所有参数，提供对应的编码提示。

注意事项 #

• 方案1更符合Python类型系统的设计方向，无需额外代码维护，优先推荐。
• 确保使用最新版本的Pylance，对ParamSpec、Unpack和自定义签名的支持更完善。

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