寻求QGIS插件适配方案：保留相对导入与目录结构的同时独立运行Qt GUI

我完全懂你的困扰——一边要贴合QGIS插件对相对导入的偏好，一边又想保留独立运行Qt GUI来快速调试，这种既要又要的场景确实头疼。不过结合你的目录结构和需求，有几个简单的方案可以解决，而且完全不需要改动现有代码里的相对导入或者目录结构。

方案一：在app/main.py中自动添加项目根目录到Python路径 #

这是最省心的方法，只需要在main.py开头加几行代码，让Python能识别到项目根目录作为顶层包，这样processing、resources里的相对导入就能正常解析了。

修改你的app/main.py如下：

import sys
import os

# 计算项目根目录（当前文件是app/main.py，所以上一级就是根目录）
project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), '..'))
# 把根目录加入Python的模块搜索路径
if project_root not in sys.path:
    sys.path.insert(0, project_root)

if __name__ == "__main__":
    from PyQt5 import QtWidgets
    from processing.processor_query_ui import UI_DataFinderUI

    app = QtWidgets.QApplication(sys.argv)
    ui = UI_DataFinderUI()
    ui.show()
    sys.exit(app.exec_())

这样修改后，你还是可以用原来的命令python app/main.py运行独立GUI，Python会自动把项目根目录当成顶层包，processing/里的相对导入（比如from .A_processor import ...或者from ..resources.response_codes import ...）都会被正确识别，完全不影响QGIS插件的运行逻辑。

方案二：用Python模块方式运行（推荐遵循Python规范） #

如果你更习惯用Python的标准模块运行方式，只需要确保所有子目录（app/、processing/、resources/）都有空白的__init__.py文件（你说已经加过了，刚好符合要求），然后在项目根目录下执行：

python -m app.main

注意这里用的是模块路径app.main而不是文件路径，Python会自动把根目录加入模块搜索路径，这样相对导入就能正常工作，不需要修改main.py的代码。

方案三：临时设置PYTHONPATH环境变量 #

如果你只是临时调试，不想改代码也不想用模块运行方式，可以在运行main.py前先把项目根目录加入PYTHONPATH：

• Linux/macOS终端：

  export PYTHONPATH=/绝对路径/到你的项目根目录 && python app/main.py
  

• Windows命令行：

  set PYTHONPATH=C:\绝对路径\到你的项目根目录 && python app\main.py
  

为什么这些方案能解决问题？ #

你之前遇到的ImportError: attempted relative import beyond top-level package，本质是因为直接运行app/main.py时，Python会把app/目录当成顶层包，而不是你的项目根目录。这时候processing/里的from ..resources就会试图跳出app/这个顶层包，自然报错。而上面的方案都是让Python把项目根目录识别为顶层包，这样所有子目录的相对导入都能在正确的包层级里解析。

而且这些方案完全不会影响QGIS插件的运行——QGIS加载插件时，本来就会把你的插件目录当成顶层包，相对导入的逻辑和之前完全一致，没有任何冲突。

备注：内容来源于stack exchange，提问作者skytwosea