如何从其他包导入符号并明确标记为当前包的API？

以下是几种简洁且规范的实现方式：

方法一：使用__all__声明公开API #

这是Python定义包公开API的标准方式，既能让IDE识别到符号是被导出的（不会提示未使用），也能明确告知代码维护者该符号属于包的对外接口。

在包b的__init__.py中添加：

from a import some_function

# 声明当前包的公开API列表
__all__ = ["some_function"]

当用户通过from b import *导入时，只会获取__all__中列出的符号；同时IDE会识别到some_function被纳入了公开API，不会标记为未使用导入。

方法二：添加明确注释说明用途 #

如果不想维护__all__列表，可以给导入语句添加清晰的注释，直接说明该导入是为了对外暴露API：

from a import some_function  # 作为b包的公开API对外提供，非冗余导入

这种方式简单直接，代码维护者能立刻明白意图，部分IDE也会根据注释忽略“未使用”的提示。

方法三：显式赋值（配合__all__效果更佳） #

通过将导入的函数赋值给当前包的同名变量，让IDE认为该符号是当前包定义的，避免未使用提示：

from a import some_function

# 显式赋值，明确该符号属于b包的API
some_function = some_function

__all__ = ["some_function"]

或者更简洁的写法：

import a
some_function = a.some_function

__all__ = ["some_function"]

这种方式同样能让IDE识别到符号被使用，同时配合__all__可以明确对外API的范围。

内容的提问来源于stack exchange，提问作者Johannes Bauer