如何避免Python子包导入时utils泄漏至process命名空间？

我的Python包结构如下：

\package
\package\__init__.py
\package\process
\package\process\__init__.py
\package\utils
\package\utils\__init__.py

需要在\package\process\__init__.py中导入utils子包的内容，但不想让utils泄漏到process子包的命名空间——也就是用户不能通过package.process.utils访问utils。

我试过以下代码：

from .. import utils
def function1(arg: utils.DeviceType):
    return utils.helper(arg)
del utils

但调用function1时会报错name 'utils' is not defined，应该是del utils导致的。如果只在函数体内导入，又没法满足函数参数类型注解的需求。

目前我用的解决方案是：

from .. import utils
def function1(arg: utils.DeviceType):
    from .. import utils    # 顶层导入只是为了类型注解，需要删掉避免污染当前包命名空间，所以这里要再导入一次
    return utils.helper(arg)
del utils

这种重复导入的方式不够优雅，有没有更优的方案？另外，用from .. import utils as _utils标记为内部名称，会不会仍然存在泄漏问题？

方案1：利用typing.TYPE_CHECKING区分类型注解与运行时逻辑 #

TYPE_CHECKING是一个仅在类型检查阶段为True的常量，运行时会被视为False。用它可以分离类型注解的导入需求和运行时的命名空间控制：

from typing import TYPE_CHECKING

# 仅在类型检查时导入utils，运行时不执行该分支
if TYPE_CHECKING:
    from .. import utils

def function1(arg: "utils.DeviceType"):
    # 运行时在函数内部导入utils，保证逻辑正常执行
    from .. import utils
    return utils.helper(arg)

类型注解用字符串包裹（也可以省略字符串，类型检查器会识别TYPE_CHECKING分支下的导入），顶层不会保留utils引用，彻底避免命名空间泄漏。

方案2：直接导入所需成员而非整个utils包 #

如果仅用到utils中的特定类型或函数，直接导入这些成员，用完后删除顶层引用即可：

from ..utils import DeviceType, helper

def function1(arg: DeviceType):
    return helper(arg)

# 删除顶层的导入引用，防止外部访问
del DeviceType, helper

这种方式更轻量化，只引入需要的内容，同时彻底切断了外部通过package.process访问这些成员的路径。

关于_utils命名的说明 #

用from .. import utils as _utils标记为内部名称，从语法上来说，用户仍然可以通过package.process._utils访问到utils包——Python的下划线前缀只是一种约定俗成的内部标识，并非强制限制。如果你的需求是完全禁止用户通过package.process访问utils，这种方式无法彻底解决问题。

内容的提问来源于stack exchange，提问作者Diederick C. Niehorster