如何在Python中实现类似TypeScript `as`的API响应类型转换？

一、用Protocol/TypedDict定义响应结构（类似TypeScript的interface/type） #

Python 3.8+可以通过typing.Protocol（3.10+纳入标准库，3.8-3.9需安装typing-extensions）实现结构类型定义，无需创建完整类层级，只声明所需的属性/字段即可，逻辑和TypeScript的接口完全一致。

场景1：response是对象，data是包含id的字典 #

from typing import Protocol, TypedDict

# 定义data字段的字典结构
class UserData(TypedDict):
    id: int  # 根据实际类型替换为str或其他类型

# 定义响应对象的结构协议
class UserResponse(Protocol):
    data: UserData

场景2：data也是对象（有id属性） #

from typing import Protocol

class UserData(Protocol):
    id: int  # 声明id属性的类型

class UserResponse(Protocol):
    data: UserData

二、实现类型断言（类似TypeScript的as） #

直接给变量标注自定义的类型，即可完成类型转换，让Pylance识别预期的结构，消除报错：

# 标注response为我们定义的UserResponse类型，等价于TS的response as UserResponse
response: UserResponse = self.client.get_user(username=username)
user_id = response.data['id']  # 或response.data.id（根据实际结构调整）

三、备选：用assert做类型守卫 #

如果不想定义结构类型，也可以通过assert做简单的类型校验，同时让类型推断生效：

response = self.client.get_user(username=username)
# 断言response有data属性，且data包含id字段
assert hasattr(response, 'data') and isinstance(response.data, dict) and 'id' in response.data
user_id = response.data['id']

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