Python中能否为参数显式指定类类型（包括类定义内部场景）？

当然可以！你遇到的NameError是因为Python在解析类定义代码的时候，Example这个类对象还没被创建出来——当解释器处理到类内部的类型注解时，类本身还不存在于当前作用域里，所以直接写类名会触发错误。下面给你几个实用的解决办法，覆盖不同Python版本的场景：

1. 使用字符串字面量做前向引用（兼容Python 3.5+） #

把类名用单引号或双引号括起来，Python运行时不会立即解析这个注解，而主流的类型检查工具（比如mypy、PyCharm）都能正确识别这个类类型。

修正你第一个报错的__init__例子：

class Example:
  def __init__(self: 'Example') -> 'Example':
    pass

类内部普通方法的参数注解：

class Example:
  def __init__(self):
    pass

  def do_something(self, other_example_class: 'Example') -> None:
    pass

如果是跨类引用且被引用的类定义在后，也可以用这个方法：

class Example2:
  def __init__(self, data: 'Example'):
    pass

class Example:
  def __init__(self):
    pass

2. 使用from __future__ import annotations（推荐Python 3.7+） #

这个导入语句会让Python将所有类型注解当作字符串处理，延迟到实际需要解析类型（比如调用typing.get_type_hints()）时才求值。这样你可以直接写类名，不用加引号，代码更整洁易读：

from __future__ import annotations

class Example:
  def __init__(self: Example) -> Example:
    pass

  def do_something(self, other_example_class: Example) -> None:
    pass

跨类引用的场景同样适用：

from __future__ import annotations

class Example2:
  def __init__(self, data: Example):
    pass

class Example:
  def __init__(self):
    pass

注意：Python 3.11及以上版本默认启用了延迟注解特性，但为了兼容3.7-3.10版本，建议显式添加这个导入语句。

3. 使用Self类型（Python 3.11+，或兼容旧版本） #

如果你需要注解self的类型，或者方法返回当前类的实例，Python 3.11+引入了Self类型（PEP 673），可以更清晰地表达这个意图，同时避免类未定义的问题：

from typing import Self  # Python 3.11+
# 若使用Python 3.7-3.10，可通过typing_extensions库导入：from typing_extensions import Self

class Example:
  def __init__(self) -> Self:
    pass

  def do_something(self, other: Example) -> None:
    pass

Self会自动指代当前类，配合from __future__ import annotations使用的话，类内部引用Example也完全没问题。

额外说明 #

对于跨类引用的场景，如果被引用的类已经在当前作用域中定义完成（比如你的第三个例子中Example定义在Example2之前），其实直接写类名也不会报错：

class Example:
  def __init__(self):
    pass

class Example2:
  def __init__(self, data: Example):
    pass

只有当被引用的类在注解位置还未被定义时，才需要用到上述的前向引用方案。

备注：内容来源于stack exchange，提问作者Player_X_YT