如何从大型Python代码库中移除通配符导入？

一、先做项目基线与风险隔离 #

• 先确保项目有完善的版本控制（比如Git），创建专门的分支处理导入替换，避免影响主分支。
• 跑一遍项目的所有测试用例，记录当前的测试通过率，作为后续验证的基准。

二、用静态分析工具批量定位与转换 #

• 使用pyflakes或pylint先扫描所有文件，标记出通配符导入的位置，以及这些导入在文件中实际用到的符号。
• 借助autoflake配合--remove-all-unused-imports参数，但注意先在小范围测试，因为通配符导入的情况它需要准确识别使用的符号。
• 更精准的工具可以用isort结合--force-single-line-imports，不过需要配合静态分析结果，先把通配符导入替换为显式导入所有符号，再用工具清理未使用的。

三、分模块分批次处理 #

• 从依赖最底层的通用模块开始处理，这些模块被其他文件引用最多，先把它们的通配符导入替换成显式的，减少后续连锁错误。
• 对于带main函数的独立脚本，可以单独批次处理，因为它们的依赖相对独立，处理后直接运行脚本验证即可。

四、处理未解析引用的自动化技巧 #

• 遇到未解析的引用，先检查是否是因为模块间的循环导入导致的，调整导入顺序或者使用局部导入（在函数内部导入）解决。
• 利用Python的__all__属性，在被导入模块中明确列出可导出的符号，这样工具能更准确识别哪些符号可以被显式导入，同时也规范了模块的导出接口。
• 使用IDE的批量替换功能，比如PyCharm的“查找所有引用”，针对某个通配符导入的符号，批量替换为显式导入语句。

五、持续验证与迭代 #

• 每处理完一个批次的文件，就跑一遍测试用例，及时发现并修复错误，避免问题堆积。
• 逐步启用导入相关的lint规则，比如pylint的wildcard-import警告，防止后续再出现通配符导入。

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