Python 3.12如何为特定嵌套用户列表添加正确类型注解？

先拆解你的用户列表结构：

• 每个权限项是**(整数ID, 权限名称字符串)**的序列
• 每个用户条目是**(用户ID, 用户名, 全名, 权限列表)**的固定结构序列
• 用户列表是上述用户条目的集合

你之前写法的问题 #

1. 第一种写法list[list[str,list[list[str]]]]是语法错误：list的类型注解只能接受一个元素类型参数，你传入多个类型不符合规则，编辑器因此默认识别为list[list[str]]。
2. 第二种Union写法虽然覆盖了所有元素类型，但无法约束用户条目的固定长度和顺序，类型检查无法发挥实际作用，且嵌套层级过深也可能导致编辑器解析异常。

推荐方案：用Tuple定义固定结构（贴合原列表格式） #

这种方式能精确描述数据的固定顺序和类型，编辑器也能正确识别：

from typing import List, Tuple  # Python 3.9+ 可直接用内置的 list、tuple

# 定义单个权限的类型
Permission = Tuple[int, str]
# 定义单个用户的固定结构
UserEntry = Tuple[int, str, str, List[Permission]]
# 用户列表的最终类型
ListOfUsers = List[UserEntry]

def test(listofusers: ListOfUsers) -> None:
    for user_id, username, full_name, permissions in listofusers:
        print(f"用户{username}（ID:{user_id}）的权限：{permissions}")

# 测试数据
listofusers = [[167, 'john', 'John Fresno', [[538, 'Privileged'], [529, 'User']]]]
test(listofusers)

可选优化：用TypedDict改为字典结构（可读性更好） #

如果可以将用户条目从列表改为字典，类型注解会更直观，也更易维护：

from typing import List, TypedDict

class Permission(TypedDict):
    id: int
    name: str

class User(TypedDict):
    id: int
    username: str
    full_name: str
    permissions: List[Permission]

def test(listofusers: List[User]) -> None:
    for user in listofusers:
        print(f"用户{user['username']}（ID:{user['id']}）的权限：{user['permissions']}")

# 转换后的测试数据
listofusers = [
    {
        "id": 167,
        "username": "john",
        "full_name": "John Fresno",
        "permissions": [{"id": 538, "name": "Privileged"}, {"id": 529, "name": "User"}]
    }
]
test(listofusers)

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