Flask项目相对导入报错：ImportError: attempted relative import with no known parent package

错误原因 #

你直接运行admin.py脚本（比如python admin.py）时，Python会把它当作顶层模块，而非某个包的子模块，这时候相对导入（from .. import db）找不到父包的上下文，就会触发这个错误。另外，即便包结构正确，Python的模块搜索路径没包含项目根目录也可能导致问题。

解决方案 #

1. 用包的方式运行代码，而非直接执行子模块

不要直接运行admin.py，回到项目根目录server下，用模块方式启动相关代码：

• 如果要运行admin.py的逻辑：

  python -m app.main.models.admin
  

• 正常启动Flask应用的话，推荐用官方启动方式：
  在server目录下设置环境变量（Windows用set，Linux/macOS用export）：

  export FLASK_APP=app.main:create_app
  export FLASK_ENV=development
  flask run
  

  这样整个包结构会被正确识别，相对导入from .. import db就能正常工作。

2. 改用绝对导入（更稳定）

相对导入容易受运行上下文影响，改用绝对导入更可靠。在admin.py里直接写：

from app.main import db

但要确保server目录在Python的模块搜索路径里，有几种方式：

• 手动设置PYTHONPATH：在server目录下执行（Linux/macOS）：

  export PYTHONPATH=$(pwd)
  

  Windows：

  set PYTHONPATH=%cd%
  

• 把项目安装为可编辑包：在server目录下执行：

  pip install -e .
  

  这样Python会自动把项目根目录加入搜索路径。

3. 确认__init__.py的定义正确

确保app/main/__init__.py里的db是全局可导入的，比如：

from flask_sqlalchemy import SQLAlchemy

# 初始化db对象
db = SQLAlchemy()

def create_app(config):
    app = Flask(__name__)
    app.config.from_object(config)
    # 绑定db到app
    db.init_app(app)
    # 其他初始化逻辑...
    return app

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