如何在Python本地包__init__.py中统一导入公共包避免重复导入

Python 中每个.py文件都是独立的模块，拥有专属的全局命名空间，你在包的__init__.py中导入的依赖默认只会存在于包本身的命名空间，不会自动注入到同包下其他子模块的命名空间中，这也是你测试代码报错的直接原因。

可行方案 #

方案1：统一公共依赖导出（最推荐，符合Python规范） #

该方案既实现了依赖统一管理，又具备最高的可维护性：

1. 在models/__init__.py中统一导入所有公共依赖：

# models/__init__.py
import sqlite3
__version__ = "你的版本号"

2. 每个子模型文件仅需从当前包导入公共依赖，不需要重复写全路径导入：

# 任意模型文件示例
from . import sqlite3

def db_operation():
    conn = sqlite3.connect("你的数据库路径")
    # 后续业务逻辑

如果后续需要替换sqlite3为其他数据库驱动，只要修改__init__.py中的导入语句即可，所有子模块无需改动。

方案2：Flask生态专用方案 #

Flask场景下更推荐使用Flask-SQLAlchemy管理数据库，完全不需要手动导入sqlite3：

1. 在models/__init__.py中初始化数据库实例：

from flask_sqlalchemy import SQLAlchemy
db = SQLAlchemy()
__version__ = "你的版本号"

2. 每个模型文件直接导入db实例定义数据结构即可：

from . import db

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True)
    # 其他字段定义

方案3：自动注入依赖（不推荐生产环境使用） #

如果确实不想在每个子模块写任何导入语句，可以通过主动修改子模块命名空间实现，但可读性差，后期维护成本高：
在models/__init__.py中按如下写法：

import sqlite3
import sys
# 导入所有子模块
from . import one, two, three

# 把公共依赖注入到每个子模块的全局命名空间
for mod_name in ['one', 'two', 'three']:
    mod = sys.modules[f'models.{mod_name}']
    mod.sqlite3 = sqlite3

注意必须保证__init__.py中先导入公共依赖，再导入子模块，否则子模块中定义函数时仍然会报变量未定义的错误。

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