Python如何复用内层函数的type hints作为外层函数的类型注解？

静态类型检查器（如Pylance、mypy）的核心工作逻辑是不执行任何运行时代码，仅基于静态语法结构做分析。你使用的get_type_hints是运行时才会执行的函数，静态检查器不会计算它的返回值，因此变量a在静态分析阶段的类型不会被识别为int，自然不会对传入字符串的outer调用触发告警。

PEP 563的延迟注解特性也解决不了这个问题：该特性只是把类型注解存储为字符串推迟到运行时求值，不会让静态检查器主动执行运行时代码来解析动态生成的类型值，直接取用__annotations__的字符串值同理，也不属于静态检查的可识别范围。

这个问题既不是Python语法不支持，也不是静态检查工具的限制，是你的写法混淆了运行时逻辑和静态类型检查的边界：动态生成的类型注解本来就不属于静态检查的可识别范围，静态检查器无法推断运行时才能确定的类型值。

方案1：统一定义类型别名（适合参数少的场景） #

直接把需要复用的参数类型抽成公共类型别名，后续修改参数类型只要改别名一处即可：

from typing import TypeAlias

# 统一定义参数类型，后续修改只要改这一处
InnerParamType: TypeAlias = int

def inner(inner_param: InnerParamType) -> int:
    return inner_param

def outer(my_param: InnerParamType) -> None:
    result = inner(my_param)
    print(result)

outer("asd") # 会正常触发类型告警

方案2：用ParamSpec复用完整函数签名（适合多参数、签名频繁调整的场景） #

如果内层函数参数多，或者后续可能频繁调整参数列表，可以用ParamSpec捕获内层函数的完整签名，直接复用给外层函数：

from typing import ParamSpec, Callable

P = ParamSpec("P")

def inner(inner_param: int, other_param: str) -> int:
    return inner_param

# 捕获inner的完整签名类型
inner_ty: Callable[P, int] = inner

def outer(*args: P.args, **kwargs: P.kwargs) -> None:
    result = inner(*args, **kwargs)
    print(result)

outer("asd", "test") # 第一个参数传字符串会正常触发告警

方案3：用functools.wraps继承签名（简单封装场景） #

如果外层函数只是对inner的简单封装，参数顺序、名称完全和inner一致，可以直接用functools.wraps继承inner的所有类型元数据：

import functools

def inner(inner_param: int) -> int:
    return inner_param

@functools.wraps(inner)
def outer(inner_param) -> None:
    result = inner(inner_param)
    print(result)

outer("asd") # 会正常触发类型告警

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