如何在Python类__init__方法中为参数及当前类添加类型提示？

针对你遇到的类未完成定义就需要在参数中引用自身类型的问题，有三种实用解决方式：

1. 使用字符串字面量标注类型 #

直接将类型名称用字符串包裹，主流类型检查工具（如mypy、PyCharm）都能正确识别这种引用：

class Node:
    def __init__(self, value: int | None = None, next_item: "Node" | None = None):
        self.value: int | None = value
        self.next_item: Node | None = next_item

注意：原代码中value: int = None的写法不符合类型规范，因为int类型不能接收None值，需明确标注为可选类型（Python 3.10+用int | None，低版本可从typing导入Optional[int]）。

2. 导入__future__.annotations延迟解析类型 #

Python 3.7及以上版本可通过导入该特性，让所有类型提示以字符串形式存储，直到运行时才进行解析，这样就能直接写Node作为类型：

from __future__ import annotations

class Node:
    def __init__(self, value: int | None = None, next_item: Node | None = None):
        self.value: int | None = value
        self.next_item: Node | None = next_item

这种方式让代码更简洁，无需手动添加字符串引号。

3. 结合typing.Self（Python 3.11+） #

如果需要标注self的类型，Python 3.11引入的Self类型可以直接使用，对于next_item的类型标注，仍可搭配上面两种方法：

from typing import Self

class Node:
    def __init__(self: Self, value: int | None = None, next_item: "Node" | None = None):
        self.value: int | None = value
        self.next_item: Node | None = next_item

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