如何让PyCharm将**kwargs识别为TypedDict类型而非Dict[str, MyType]

方案1：使用Python 3.11+的Unpack注解（推荐） #

PEP 692引入的Unpack类型专门用于注解关键字参数的结构，PyCharm对该语法支持完善，能正确识别kwargs的实际类型：

from typing import TypedDict, Unpack
from pydantic import BaseModel

class PydanticPayload(BaseModel):
    data: str  # 示例字段，可根据实际需求调整

class MyType(TypedDict):
    request: PydanticPayload
    args: dict[str, any]

def handle_request(**kwargs: Unpack[MyType]) -> None:
    # 此时PyCharm会正确识别kwargs包含request和args字段
    print(kwargs["request"].data)

方案2：改用直接传入TypedDict类型参数（兼容旧Python版本） #

如果项目使用Python 3.10及以下版本，无法使用Unpack，可以直接把kwargs声明为MyType类型，调用时用**展开传入：

from typing import TypedDict
from pydantic import BaseModel

class PydanticPayload(BaseModel):
    data: str

class MyType(TypedDict):
    request: PydanticPayload
    args: dict[str, any]

def handle_request(kwargs: MyType) -> None:
    print(kwargs["request"].data)

# 调用方式1：直接传字典
payload = PydanticPayload(data="test")
handle_request({"request": payload, "args": {"key": "value"}})

# 调用方式2：用**展开字典
my_kwargs = {"request": payload, "args": {"key": "value"}}
handle_request(**my_kwargs)

这种写法PyCharm能直接识别kwargs的类型结构，不会出现误判。

方案3：使用类型断言修正识别结果 #

如果一定要保留**kwargs的写法，可以在方法内部通过类型断言告诉PyCharmkwargs的实际类型：

Python 3.10+版本用assert_type #

from typing import TypedDict, assert_type
from pydantic import BaseModel

class PydanticPayload(BaseModel):
    data: str

class MyType(TypedDict):
    request: PydanticPayload
    args: dict[str, any]

def handle_request(**kwargs) -> None:
    # 类型断言，明确告知PyCharm kwargs的类型
    kwargs = assert_type(kwargs, MyType)
    print(kwargs["request"].data)

更早Python版本用cast #

from typing import TypedDict, cast
from pydantic import BaseModel

class PydanticPayload(BaseModel):
    data: str

class MyType(TypedDict):
    request: PydanticPayload
    args: dict[str, any]

def handle_request(**kwargs) -> None:
    kwargs = cast(MyType, kwargs)
    print(kwargs["request"].data)

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