PyQt/PySide公共资源文件及资源文件位置问题咨询

核心结论 #

不需要为每个UI表单目录单独创建qrc文件，完全可以在单一位置维护一套公共图标集的qrc文件，供所有目录下的UI表单共用。

具体实现步骤 #

1. 整理公共资源结构

把公共qrc文件（比如icons.qrc）和所有图标资源放在统一的共享目录，例如\Modules\ZA\RES\，确保qrc文件内的图标路径是相对于该共享目录的相对路径，比如：

<!-- icons.qrc 内容示例 -->
<RCC>
    <qresource prefix="/icons">
        <file>icons/save.png</file>
        <file>icons/open.png</file>
    </qresource>
</RCC>

2. 编译共享资源并配置模块导入

有两种可靠的方式解决导入问题：

方式一：将共享目录转为Python包

• 在共享目录\Modules\ZA\RES\下创建空的__init__.py文件，把该目录标记为Python包。
• 使用pyside6-rcc编译qrc文件到该目录：

  pyside6-rcc \Modules\ZA\RES\icons.qrc -o \Modules\ZA\RES\icons_rc.py
  

• 修改Qt Designer生成的UI代码中的导入语句，从import icons_rc改为：

  from ZA.RES import icons_rc
  

  （如果不想每次手动修改，可以自定义Qt Designer的代码生成模板，固定导入路径）

方式二：将共享目录加入Python搜索路径

• 保持Qt Designer生成的import icons_rc语句不变，在程序的入口文件中添加代码，把共享目录加入Python模块搜索路径：

  import sys
  sys.path.append(r'\Modules\ZA\RES')
  

  这样Python会自动在该目录下查找icons_rc.py模块。

3. 验证资源可用性

运行任意使用该公共资源的UI表单，检查图标是否正常显示，无ModuleNotFoundError报错即可。

额外说明 #

• PyQt的资源处理逻辑与PySide6完全一致，上述方案同样适用。
• 优先推荐方式一，这更符合Python的模块规范，长期维护更清晰。

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