如何为同类（含嵌套类）的方法参数添加自定义类型提示？

在Python类定义过程中，当内部类（如SymbolTable）引用外层类的另一个内部类（Lexer.symbol）时，由于外层类还未完成初始化，直接使用Lexer.symbol会触发未定义提示。以下是两种无需移动symbol类的解决方案：

方案1：使用字符串字面量作为类型提示（向前引用） #

直接将类型提示用字符串包裹，让Python延迟到类定义完成后再解析类型：

class Lexer:
    class symbol:
        def __init__(self, lexeme: str, token: str):
            self.lexeme: str = lexeme
            self.token: str = token

    class SymbolTable:
        def __init__(self):
            self.symbols: list['Lexer.symbol'] = []

        def add_symbol(self, symbol: 'Lexer.symbol'):
            pass

        def add_symbols(self, symbols: list['Lexer.symbol']):
            pass

方案2：导入__future__ annotations（Python 3.7+） #

在文件最顶部添加该导入，所有类型提示会自动被当作字符串处理，无需手动加引号：

from __future__ import annotations

class Lexer:
    class symbol:
        def __init__(self, lexeme: str, token: str):
            self.lexeme: str = lexeme
            self.token: str = token

    class SymbolTable:
        def __init__(self):
            self.symbols: list[Lexer.symbol] = []

        def add_symbol(self, symbol: Lexer.symbol):
            pass

        def add_symbols(self, symbols: list[Lexer.symbol]):
            pass

注：原代码中add_symbols的参数名与类型名重复，建议改为symbols避免命名混淆，上述代码已修正该问题。

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