Python 3.15 sys._jit.is_active 怎样判断 JIT 是否正在执行

如果你在 Python 3.15 的 CPython 中排查 JIT 行为，最容易混淆的是三个布尔值：sys._jit.is_available() 表示解释器是否具备 JIT，sys._jit.is_enabled() 表示当前进程是否打开 JIT，而 sys._jit.is_active() 只回答“当前最顶层 Python 帧此刻是否正在执行 JIT 代码”。

官方地址：https://docs.python.org/3.15/library/sys.html#sys._jit

判断“JIT 是否正在执行”时看 is_active()，但它是 CPython 的实验性实现细节，只适合 JIT 本身的测试和调试，不应拿来控制业务逻辑。

先区分三个状态：可用、启用与正在执行

可以把三个方法看成从外到内的三层。is_available() 先看当前 Python 可执行文件是否在构建时支持 JIT；官方文档给出的构建开关是 Windows 的 --experimental-jit，以及其他平台的 --enable-experimental-jit。

只有 JIT 可用时，is_enabled() 才可能为真。它反映当前进程的启动状态，可通过解释器启动时的 PYTHON_JIT=0 或 PYTHON_JIT=1 控制。即使它为真，也不等于每一行 Python 代码都正在由 JIT 执行。

is_active() 的范围更窄：它观察当前最顶层 Python 帧。调用点、当前帧是否已经进入 JIT，以及调用本身对执行路径的影响，都可能让一次观察结果和下一次不同。

用一个兼容函数读取诊断状态

诊断脚本不应假定所有 Python 实现和所有构建都提供 sys._jit。下面的函数先用 getattr 取得模块属性，再分别读取三个方法；缺少某一层时返回 None，这样输出可以明确表示“无法观察”，而不是把它误写成 JIT 关闭。

import sys

def get_jit_state():
    # sys._jit 是 CPython 实现细节，缺少时让诊断脚本平稳返回。
    jit = getattr(sys, "_jit", None)
    if jit is None:
        return {"available": None, "enabled": None, "active": None}

    # 三个方法观察的层级不同，分别保留为独立字段。
    return {
        "available": jit.is_available(),
        "enabled": jit.is_enabled(),
        "active": jit.is_active(),
    }

state = get_jit_state()
# 只把结果用于诊断输出，不让它改变业务路径。
print(state)

这里的 None 有实际含义：可能是解释器不提供 sys._jit，也可能是当前运行环境不适合观察。不要把它和 False 混为一谈。对于官方保证的 Python 3.15 CPython JIT 构建，通常可以看到三个布尔字段；在其他实现上则应保留兼容分支。

为什么不能反复调用 is_active 做业务判断

官方文档特别提醒，追踪式 JIT 会让重复调用 is_active() 得到令人意外的结果。如果把返回值放进分支，分支本身可能导致代码进入或退出 JIT，于是前后两次调用不再处于同一个执行状态。

因此，下面这种写法不适合生产逻辑：

import sys

def choose_algorithm(data):
    # 反例：JIT 活动状态不是稳定的业务能力开关。
    if sys._jit.is_active():
        return fast_path(data)
    return safe_path(data)

如果确实要研究 JIT 的行为，应把观察代码缩小到测试或调试工具中，记录一次状态与对应上下文，不要据此宣称某个算法一定更快，也不要在循环中不断读取它改变控制流。

按构建和启动条件排查

遇到三个值不符合预期时，按这个顺序看：第一，确认正在运行的是目标 Python 3.15 CPython，而不是另一个解释器；第二，看构建是否包含实验性 JIT 支持，这决定 is_available()；第三，检查进程启动时的 PYTHON_JIT，它影响 is_enabled()；最后才把 is_active() 当作某一瞬间的调试观察。

这四步解决的是不同问题：可用性是“有没有这项能力”，启用性是“本进程是否打开”，活动性是“当前帧这一刻是否正在运行 JIT”。如果第一层为假，后面没有继续解释的必要；如果第二层为假，活动状态也不会成立；如果前两层为真，活动状态仍然可能随执行位置变化。

常见问题

is_active() 为真是不是说明整个程序都在 JIT 中？

不是。它只描述当前最顶层 Python 帧，不能外推到整个进程、所有线程或所有函数。

可以用它判断线上环境是否启用了 JIT 吗？

不应该。判断进程是否启用应看 is_enabled()；is_active() 是瞬时的帧级观察，而且官方建议仅用于测试和调试 JIT。

为什么诊断函数要返回 None？

因为没有 sys._jit 时，“无法观察”和“明确关闭”是两种不同状态。保留三态结果，后续日志或测试才能做出正确解释。

最后记住这条判断链：先看 is_available()，再看 is_enabled()，只有在 JIT 调试场景中才观察 is_active()。这样既能定位 Python 3.15 的运行时状态，也不会把实验性实现细节误当成应用层契约。