Windows下Vectorbt导入挂起，如何启用Numba JIT正常初始化？

为什么导入时会挂起？ #

Vectorbt在导入阶段会触发Numba对大量核心计算函数的即时（JIT）编译，在Windows系统下，挂起通常由以下原因导致：

• 杀毒软件拦截：Numba编译时会生成临时可执行代码，部分杀毒软件会将其误判为恶意程序，拦截编译进程导致挂起。
• 文件权限问题：Numba默认将编译缓存写入系统临时目录，若当前用户无写入权限，编译进程会陷入等待。
• 多线程编译冲突：Numba默认启用多线程加速编译，Windows下部分环境会出现线程死锁，导致导入卡住。
• CPU指令集兼容性：部分特殊CPU（如老款AMD或小众架构）与Numba默认的指令集优化不兼容，编译过程出现异常阻塞。

启用全JIT的解决方案 #

以下是可尝试的解决方法，按优先级排序：

1. 临时关闭杀毒软件或添加白名单 #

暂停Windows Defender或第三方杀毒软件的实时防护，或把Python.exe进程添加到杀毒软件的信任列表，避免编译进程被拦截。

2. 指定Numba缓存目录并赋予权限 #

手动设置一个有写入权限的目录作为Numba缓存目录，避免系统临时目录的权限问题：

import os
# 替换为你有权限的本地路径，比如用户目录下的自定义文件夹
os.environ["NUMBA_CACHE_DIR"] = "C:/Users/你的用户名/Documents/NumbaCache"
os.makedirs(os.environ["NUMBA_CACHE_DIR"], exist_ok=True)
import vectorbt as vbt

3. 限制Numba编译线程数 #

禁用多线程编译，避免线程死锁：

import os
os.environ["NUMBA_NUM_THREADS"] = "1"
import vectorbt as vbt

4. 预生成Numba编译缓存 #

先在禁用JIT的模式下导入一次，让Vectorbt完成缓存骨架的生成，之后正常导入时Numba会直接复用缓存：

• 第一步（生成缓存）：

import os
os.environ["NUMBA_DISABLE_JIT"] = "1"
import vectorbt as vbt

运行后退出Python环境，此时Numba缓存已生成。

• 第二步（正常导入）：
  直接运行import vectorbt as vbt即可，无需再禁用JIT。

5. 强制Numba使用通用CPU指令集 #

如果是CPU指令集兼容性问题，强制Numba使用通用模式编译：

import os
os.environ["NUMBA_CPU_NAME"] = "generic"
import vectorbt as vbt

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