如何以兼容未来版本的方式使用from __future__ import annotations指令

嘿，这个问题简直说到了长期维护库的开发者心坎里——既要照顾老版本的语法需求，又要为未来Python版本的变化提前铺路，这种两难太真实了！我来分享几个实际可行的方案，帮你搞定这个兼容问题：

方案1：暂时保留导入，兼容新旧版本（最简单的选择） #

Python 3.14只是把这个导入标记为弃用，不是直接移除——也就是说，你的代码在3.14+上依然能跑，只是会弹出一个DeprecationWarning。等到这个导入真正被移除的版本（至少2029年后），那时候Python的默认行为已经和这个导入开启的效果一致了（注解自动延迟求值），你只要批量删掉所有文件里的这个导入就行。

如果不想看到3.14+的警告，只需要在文件开头（导入__future__之后）加几行代码过滤警告：

from __future__ import annotations
import warnings

# 过滤annotations导入的弃用警告
warnings.filterwarnings(
    "ignore",
    category=DeprecationWarning,
    message=r".*from __future__ import annotations is deprecated.*"
)

这个方案的好处是完全不用改现有代码结构，也不需要复杂的打包流程，等未来支持的最低版本升到3.14+时，再全局删掉导入和过滤代码就行，成本极低。

方案2：手动使用字符串注解，彻底摆脱__future__依赖 #

如果你想从根源上避免这个导入的麻烦，可以直接把所有注解写成字符串形式——这其实就是from __future__ import annotations开启后的默认行为。比如：

# 代替原来的写法
# def process_items(items: list[int]) -> dict[str, bool]:

# 直接写字符串注解
def process_items(items: 'list[int]') -> 'dict[str, bool]':
    pass

这种写法在所有Python版本里都能正常工作，完全不需要依赖__future__导入。唯一的缺点是写起来稍微繁琐一点，复杂类型的可读性会打折扣，但胜在绝对兼容，没有版本顾虑。

方案3：极简打包预处理（尽量不搞复杂流程） #

如果你实在不想看到警告，也不想写字符串注解，可以在打包前用一个简单的脚本批量处理代码：比如用sed或者Python脚本，把所有from __future__ import annotations行注释掉或者删除，然后针对不同Python版本生成不同的发行版？不过正如你担心的，这会导致非通用轮子，增加打包复杂度，所以除非万不得已，不推荐这个方案。

总结一下，最推荐的是方案1——暂时保留导入+过滤警告，这是成本最低、最省心的未来兼容方式，毕竟距离这个导入被真正移除还有好几年时间，足够你逐步迁移代码或者升级支持的最低Python版本。

备注：内容来源于stack exchange，提问作者Anthon