Numba嵌套使用jitclass时annotations导入触发NameError问题咨询

1. 删除from __future__ import annotations后问题解决的原因 #

from __future__ import annotations是PEP 563提出的延迟注解特性，开启后Python不会在定义类的时候立即解析类型注解，而是把所有注解以原始字符串的形式存储。
numba的jitclass装饰器在扫描类的属性类型注解时，默认会直接取注解的实际值进行类型匹配，不会主动解析字符串形式的注解。你在MyClass中写的params: Parameters，开启延迟注解后存储的是字符串"Parameters"，numba无法将这个字符串映射到已经定义的Parameters类，就会抛出NameError。删除该导入后，Python会在定义MyClass时直接解析Parameters为实际的类对象，numba能正确识别类型，因此运行正常。

2. 该场景下删除annotations导入的风险 #

只要你的项目中不存在前向引用的需求（即类型注解用到的类，定义顺序在使用注解的代码之后），删除该导入没有任何风险。
如果后续你需要使用前向引用，常规Python写法可以把注解用引号包裹（比如params: "Parameters"），但这种写法同样不会被当前版本的numba识别，依旧会触发类型解析错误。因此在使用numba的代码模块中，除非后续numba官方完善了对PEP 563延迟注解的支持，否则不建议开启该特性。

3. jitclass嵌套使用的合规性 #

这种嵌套写法是官方支持的合规用法，只要满足两个前提：

• 嵌套用到的内部jitclass（也就是你的Parameters），必须在外部jitclass（MyClass）之前完成定义和装饰
• 类型注解可以被numba正确识别为对应的jitclass类型
  你提到的deferred_type方案也是官方推荐的嵌套jitclass解决方案，它的失效同样是因为延迟注解特性导致numba无法拿到实际的类型对象，和你的写法本身无关。

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