Python中如何标记重导出的导入项 避免被autoflake等工具误删

在Python中，如果导入某个模块仅为使用其副作用，无法用autoflake这类工具自动移除未使用的import。此前通用的规避写法如下：

import something
assert something, "Something is imported for its side effects."

但如果导入内容的目的是重导出，上述写法就不适用了。典型场景示例：
api.py代码：

from internal_details import version

main.py代码：

import api
print(api.version)

Python没有原生的export语法，因此autoflake、Pylint等静态检查工具无法识别导入的version是为了暴露给其他模块调用，会误判为未使用的导入。直接复用副作用导入的assert version写法无法生效，而assert True or version的写法语义模糊、不够优雅。

最优解决方案 #

推荐使用__all__显式声明模块的公开导出项，这是Python社区公认的标准写法，所有主流静态检查工具（autoflake、Pylint、pyright等）原生支持识别，不会误判未使用导入：

# api.py
from internal_details import version

__all__ = ["version"]

该方案的优势非常明确：

• 完全符合Python官方的模块公开接口约定，属于行业通用标准，不存在工具兼容性问题
• 代码语义清晰，所有开发者都能立刻明白version是模块对外暴露的公开接口
• 无额外运行时开销，__all__是模块级的普通变量，仅用于静态检查和from module import *场景的导入逻辑

如果需要兼容极少数不识别__all__的老旧检查工具，也可以选用运行时无开销的引用标记写法，语义同样清晰：

# api.py
from internal_details import version

# 标记为公开导出项
[version]

这种写法本质是创建了一个未赋值的列表字面量，运行时不会产生任何副作用，同时所有静态检查工具都会识别到version被引用，不会判定为未使用导入。

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