Flask项目遇attempted relative import with no known parent package报错求助

错误原因 #

直接运行子模块（比如auth.py）时，Python会将其视为顶层脚本文件，不会识别它属于Project这个包，因此相对导入逻辑失效。

正确解决方案 #

1. 保留正确的导入语法（auth.py中） #

from . import db是符合包结构的正确相对导入方式，问题出在项目运行方式，而非导入代码本身。

2. 以包的方式启动项目 #

回到Project的上级目录，执行以下命令启动项目：

python -m Project

该命令会告诉Python将Project当作一个完整包加载，此时相对导入就能正常生效。

3. 完善__init__.py的应用入口 #

如果需要直接运行__init__.py，可以补充完整Flask应用的初始化代码：

from flask import Flask
from flask_sqlalchemy import SQLAlchemy

db = SQLAlchemy()

def create_app():
    app = Flask(__name__)
    # 配置数据库（示例使用SQLite）
    app.config['SQLALCHEMY_DATABASE_URI'] = 'sqlite:///site.db'
    app.config['SQLALCHEMY_TRACK_MODIFICATIONS'] = False
    
    db.init_app(app)
    
    # 注册auth模块的蓝图（若auth.py中定义了蓝图）
    from .auth import auth_bp
    app.register_blueprint(auth_bp)
    
    return app

# 仅在直接运行__init__.py时启动服务
if __name__ == '__main__':
    app = create_app()
    app.run(debug=True)

之后在Project目录下直接运行：

python __init__.py

4. 临时调试子模块的方法 #

如果需要单独调试auth.py，可以在文件开头添加路径配置，将项目根目录加入Python的搜索路径：

import sys
from pathlib import Path

# 将Project目录添加到Python路径
sys.path.append(str(Path(__file__).parent))

# 此时可正常导入db
from . import db

其他导入方式失败的原因 #

• from .. import db：Project本身就是顶层包，没有上级包结构，因此报错
• from project import db：Python默认不会将当前工作目录的子目录加入搜索路径，除非手动配置sys.path
• from .project import db：Project是当前目录，不存在名为project的子模块，因此报错

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