Python 3.15 lazy import 怎么渐进接入：模块声明、首次访问与兼容边界

一个命令行工具明明只打印帮助信息，却先加载了报表、图像和网络依赖，启动时间自然被不必要的模块拖长。Python 3.15 的 lazy import 可以把指定模块的加载推迟到名称首次被使用时，但它不是“给所有 import 加速”的全局魔法。更稳妥的做法，是先从入口模块里的重依赖开始，小范围验证错误位置和副作用。

先弄清 lazy import 的三个边界

PEP 810 把 lazy 设计成软关键字，只在模块顶层的 import 语句中生效。下面两种写法都属于显式选择：

lazy import json
lazy from json import dumps, loads

声明发生时，名称绑定到代理对象；目标模块暂时不会进入 sys.modules，但诊断信息可以从 sys.lazy_modules 观察。第一次真正读取该名称时，代理才解析成目标模块或具体成员。惰性不会递归传播到被导入模块内部，普通 import 的行为也不会自动改变。

首次访问时，错误和副作用也会后移

惰性导入节省的是“这次运行根本没用到该依赖”时的加载工作，并没有消除加载成本。更重要的是，ImportError、依赖初始化失败以及模块顶层副作用，不再发生在声明行，而可能出现在第一次读取名称的位置。日志、异常捕获和测试用例都要围绕这个新位置重新核对。

lazy from json import dumps, loads 会给两个名称各放一个代理。首次使用 dumps 时会加载整个 json 模块，但只把 dumps 解析成真实对象；未访问的 loads 仍可保持代理状态。这个细节很适合大型入口模块，却不适合依赖导入副作用完成注册的插件。

把渐进接入拆成可控范围

我更建议从 CLI 入口开始：挑一个体积大、在帮助页或简单子命令中经常不用到的重依赖模块，先改成惰性；有注册、信号处理或全局钩子的副作用模块继续使用普通 import。这样问题边界清晰，回退也简单。

__lazy_modules__ = {"report_engine"}

import report_engine
import plugin_registry

def build_report(data):
    return report_engine.render(data)

在 Python 3.15 及以上，report_engine 可能延迟加载；旧版 Python 会忽略这份声明，仍按普通方式导入。等项目最低版本提升后，再把它改成更直观的 lazy import report_engine。若排查阶段需要全部恢复为立即导入，可用官方提供的禁用方式关闭惰性行为，而不是逐文件删除声明。

验收时不要只看一次启动耗时。至少检查帮助命令是否跳过重依赖、首次业务调用是否能正常加载、缺失依赖的错误是否出现在可理解的位置，以及插件注册是否仍在预期时机完成。任何一项不确定，都先缩小惰性范围。

常见问题

lazy import 可以写在函数里面吗？

不可以。lazy 语法只允许模块级使用；函数内需要延迟加载时，继续使用传统的局部 import。

用了 __lazy_modules__，旧版 Python 会报错吗？

不会。它在旧版本中只是普通模块全局变量，相关 import 仍按立即加载处理，因此适合作为迁移过渡。

Python 3.15.0rc2 仍属于候选版本，生产项目应先在隔离环境验证依赖和工具链。真正适合优先改造的，是入口清晰、重依赖可选、没有导入副作用的模块；范围越明确，惰性导入带来的收益越容易判断。