标注“任意 callable 函数”最标准方式是 typing.Callable[..., Any]，其中 ... 表示任意参数，Any 表示任意返回值；不可省略泛型，禁用 Callable[Any, Any] 或裸 Callable。
在 Python 类型注解中，标注“任意 callable 函数”最常用、最标准的方式是使用 typing.Callable。
基础写法：Callable[[], None]
这是最简形式，表示“不接受参数、无返回值的可调用对象”：
from typing import Callabledef run_callback(cb: Callable[[], None]) -> None: cb()
其中 Callable[[], None] 的方括号里：前一个 [] 是参数类型列表（空表示无参数），后一个 None 是返回类型。
支持任意参数和返回值：Callable[..., Any]
若你**真不需要约束参数个数、类型或返回值**（即只要它是 callable 就行），应写成：
from typing import Callable, Anydef execute(func: Callable[..., Any]) -> Any: return func()
-
...（三个点）表示“任意数量、任意类型的参数” -
Any表示返回值类型不限（也可换成object或留空，但Any最准确） - ⚠️ 注意：
Callable不接受Callable[Any, Any]这种写法 —— 它的泛型参数固定为[参数元组, 返回类型]，所以...是唯一合法的“任意参数”占位符
常见误区提醒
- ❌
Callable（不带泛型）在 Python 3.9+ 已被弃用，类型检查器（如 mypy）会警告；必须写全Callable[..., ...] - ❌ 不要用
object或typing.Any替代 —— 它们不表达“可调用”语义，IDE 无法提示.()，类型检查也会漏掉错误 - ✅ 若你知道它大概长什么样（比如接收一个 str 返回 int），优先写具体签名：
Callable[[str], int]，更安全、更易维护
Python 3.12+ 可选：使用内置的 callable 类型别名
Python 3.12 引入了 collections.abc.Callable 作为运行时协议，但类型注解仍推荐用 typing.Callable。不过你也可以用：
from collections.abc import Callable # ✅ Python 3.12+ 推荐（与 typing.Callable 行为一致） # 或 from typing import Callable # ✅ 兼容性更好（仍推荐，尤其需支持旧版本时）
两者在类型检查层面效果相同，typing.Callable 兼容性更广。
