能否将字典解构为带类型检查的关键字参数？

假设我有如下字典：

from typing import Dict
T: Dict[str, int] = {
    'a': 2,
    'b': 3,
}

我希望定义一个函数，其关键字参数来自上述字典：

def func(**T):
  print(locals())

目标是让函数的类型检查能正常工作，满足以下要求：

func(2)    # 应正常运行
func('2')  # 应正常运行
func(a=2)  # 应正常运行
func([2])  # 应提示类型问题
func(c=2)  # 应抛出TypeError

尝试后无法实现，请问这是否可行？

你想要的效果部分可行，但需要调整实现逻辑，原写法存在几个核心问题：一是**T仅能收集关键字参数，无法处理位置参数；二是普通Dict无法让类型检查工具识别允许的参数键和类型。以下是具体实现方案：

1. 用TypedDict定义参数结构 #

要让类型检查工具识别合法的关键字参数，必须用TypedDict替代普通Dict来声明参数结构，而非依赖运行时字典：

from typing import TypedDict, Union, Optional, Unpack

# 定义允许的关键字参数：可选的a、b，值均为int
class FuncParams(TypedDict, total=False):
    a: int
    b: int

2. 调整函数签名支持位置+关键字参数 #

你的需求里同时包含位置参数（func(2)这类）和关键字参数，需要在函数签名中明确处理：

def func(pos_arg: Optional[Union[int, str]] = None, **kwargs: Unpack[FuncParams]) -> None:
    # 运行时校验关键字参数的键是否合法
    allowed_keys = {'a', 'b'}
    invalid_keys = set(kwargs.keys()) - allowed_keys
    if invalid_keys:
        raise TypeError(f"不支持的关键字参数: {invalid_keys}")
    
    # 业务逻辑示例
    print(f"位置参数: {pos_arg}, 关键字参数: {kwargs}")

3. 效果验证 #

• func(2)：正常运行，类型检查通过
• func('2')：正常运行，类型检查通过
• func(a=2)：正常运行，类型检查通过（位置参数默认取None）
• func([2])：类型检查工具会提示错误（位置参数不接受列表类型）
• func(c=2)：运行时抛出TypeError，类型检查工具也会提前提示c不是合法参数

关键说明 #

• Python不支持直接从运行时字典生成函数的静态参数签名，类型检查依赖静态定义，因此必须用TypedDict显式声明参数结构。
• Unpack（Python 3.11+支持）用于让类型检查工具识别TypedDict中的键值对，确保关键字参数的类型和合法性校验生效。

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