Python 3.12相对导入报错及包名重复问题求助

问题根源 #

核心问题是模块运行方式不符合Python包导入规范：直接在包外部执行脚本、或直接运行包内模块时，Python无法正确识别包层级，导致__package__与__name__取值混乱，进而引发相对导入错误和包名重复。

具体解决方案 #

1. 改用绝对导入替代相对导入 #

放弃相对导入，统一使用绝对导入避免层级混淆：

• 在Main.py中导入模块：

  from postApp import Database, Models, Schemas, Utils
  from postApp.Routers import Post, User
  

• 在Routers/Post.py、Routers/User.py中导入模块：

  from postApp import Database, Models, Schemas, Utils
  

2. 正确设置Python路径并以包方式导入 #

在包外的test.py中，先将postApp的父目录加入Python路径，再按包层级导入：

import sys
from pathlib import Path

# 将postApp所在的父目录添加到Python搜索路径
sys.path.append(str(Path(__file__).parent))

# 按正确包结构导入模块
from postApp import Main
from postApp.Routers import Post, User

3. 禁止直接运行包内模块 #

不要用python postApp/Main.py这类命令直接运行包内模块。如果需要启动Main的功能，有两种正确方式：

• 在包外的test.py中调用：

  from postApp.Main import run_app  # 假设Main中有入口函数run_app
  if __name__ == "__main__":
      run_app()
  

• 从postApp的父目录出发，用-m参数以模块方式运行：

  python -m postApp.Main
  

这种方式会让Python正确识别包结构，__package__会被正确赋值为postApp，彻底解决包名重复问题。

4. 统一模块/目录命名（可选但推荐） #

Python模块名区分大小写，且PEP8规范推荐小写命名。建议将目录Routers改为routers，所有模块文件名改为小写（如Database.py→database.py），修改后目录结构：

postApp
    routers
        post.py
        user.py
        __init__.py
    database.py
    main.py
    models.py
    schemas.py
    utils.py
    __init__.py

对应的导入语句同步调整为小写，例如from postApp.routers import post，避免跨平台命名问题。

验证效果 #

修改完成后，运行包外的test.py，__package__ + '.' + __name__的输出会变为预期的postApp.main、postApp.routers.post格式，所有相对导入错误也会消失。

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