PAYATHON 2026

Python 中 __future__ 导入是否会被缓存?

数据小陈

结论:from __future__ import ... 是编译期指令,运行时不会执行导入查找。它不像 import foo 那样借助 sys.modules 缓存并复用某个 future 特性。bar 里启用的 future 特性只在编译 bar 时起作用,导入 bar 的模块不会自动获得同样的设置。普通 import __future__ 才是模块导入,会进入 sys.modules。__future__ 会不会出现在 sys.modules 里,取决于此前是否发生过普通导入、运行环境是否已经加载过它;只写 from __future__ import ... 通常不会把它加进去。

原因

future 语句(比如 from __future__ import annotations)要放在模块顶部附近,由解析器和编译器识别。它给当前模块设置 future 编译标志,改变当前模块代码对象的编译结果,运行时并不执行一次 import 查找。所以不存在“导入一次 future 特性,后面的模块都复用这份缓存”这种传播机制。

每个模块的 future 标志各自独立。baz.py 导入 bar.py,只是执行 bar.py 已经编译好的代码,bar.py 的 future 标志不会带进 baz.py。baz.py 需要同一特性,就得在自己顶部声明。

如何检查

想知道 __future__ 在不在缓存里,看 sys.modules;想知道某个 future 特性有没有生效,看对应模块源码顶部有没有那条 future 语句。sys.modules 里有没有 __future__ 说明不了后者。

普通导入 __future__ 会进缓存:

import sys
import __future__

print('__future__' in sys.modules)
print(sys.modules['__future__'].__name__)

输出是 True 和 __future__。这只说明 __future__ 模块被普通导入并缓存了,当前模块并没有因此启用某个 future 特性。

from __future__ import ... 一般不会触发普通导入。可以用两个文件观察,在干净的解释器进程里,结果通常不会因为这条 future 语句而改变:

# a.py
from __future__ import annotations
# check.py
import sys

print('before:', '__future__' in sys.modules)
import a
print('after:', '__future__' in sys.modules)

运行 python check.py。如果 before 已经是 True,说明解释器环境或之前的导入链已经普通加载过 __future__,这时不能把原因算到 a.py 的 future 语句头上。

模块间不会自动传播

下面的 bar.py 启用了 annotations future:

# bar.py
from __future__ import annotations

def f(x: list[int]) -> None:
    pass

导入 bar 的 baz.py 不会自动继承这个设置:

# baz.py
# 如果也要启用,必须在文件顶部附近自己声明:
# from __future__ import annotations

import bar

def g(x: list[int]) -> None:
    pass

baz.py 是否启用该 future 特性,取决于它自己的 future 语句。

注意事项

  • from __future__ import feature 是逐模块的编译期设置,不是运行时的模块属性缓存。
  • 普通 import __future__ 只加载模块本身,不会回头改变当前模块或其他模块的 future 标志。
  • future 语句必须放在模块顶部附近,位置不对会抛 SyntaxError。
  • sys.modules 是进程级缓存,受启动环境、交互式环境和第三方库导入的影响;检查时尽量用干净进程。

备注:内容仅供参考。