pip安装Python包时项目资源存放位置及PyQt图片访问问题咨询

嘿，针对你的PyQt项目在Ubuntu下打包成pip包和独立可执行文件时的图片资源问题，我给你整理了清晰的解决方案，分两种场景来说明：

当你要把项目做成可通过pip安装的包时，首先得调整项目结构，把图片资源放到包目录内，然后通过setuptools配置资源包含，最后在代码中用Python的资源访问规范来读取。

项目结构调整 #

建议把资源放在包内部的子目录里，比如这样：

your_project/
├── your_package/
│   ├── __init__.py
│   ├── main_window.py  # 你的GUI代码文件
│   └── resources/
│       └── images/
│           └── new.jpeg
├── setup.py
└── pyproject.toml

配置setup.py包含资源 #

在setup.py里通过package_data参数声明要包含的资源文件，确保安装时图片会被一起打包：

from setuptools import setup, find_packages

setup(
    name="your_package",
    version="0.1.0",
    packages=find_packages(),
    # 声明要包含的资源文件
    package_data={
        "your_package": ["resources/images/*.jpeg"],
    },
    include_package_data=True,
    # 其他必要配置（比如入口点、依赖等）
)

代码中访问图片资源 #

不要再用相对路径了，改用Python标准库的importlib.resources来获取资源路径，这是跨环境的可靠方式：

import importlib.resources
from PyQt5.QtGui import QPixmap
from PyQt5.QtWidgets import QLabel

# 获取图片的绝对路径
with importlib.resources.path("your_package.resources.images", "new.jpeg") as img_path:
    pixmap = QPixmap(str(img_path))
    # 示例：把图片放到QLabel里
    label = QLabel()
    label.setPixmap(pixmap)

如果你的Python版本是3.9及以上，还可以用更简洁的importlib.resources.files：

from importlib.resources import files

img_path = files("your_package.resources.images").joinpath("new.jpeg")
pixmap = QPixmap(str(img_path))

如果要生成Ubuntu下的独立可执行文件，PyInstaller是最常用的工具，这时候需要告诉它包含图片资源，同时代码里要适配打包后的环境。

步骤1：生成并编辑.spec文件 #

先运行命令生成基础的.spec文件：

pyinstaller --name your_app your_package/main_window.py

然后打开生成的your_app.spec文件，在Analysis部分的datas列表里添加资源映射，格式是(源路径, 目标路径)：

a = Analysis(
    ['your_package/main_window.py'],
    # 其他默认参数...
    datas=[('your_package/resources/images/*.jpeg', 'resources/images')],
    # 其他默认参数...
)

这个配置的意思是：把项目里的your_package/resources/images/*.jpeg文件，打包后放到可执行文件所在目录的resources/images子目录下。

步骤2：代码中适配打包环境 #

打包后，PyInstaller会把资源放到一个临时目录，我们可以通过sys._MEIPASS变量获取这个路径，同时兼容开发环境的路径：

import sys
import os
from PyQt5.QtGui import QPixmap

def get_resource_path(relative_path):
    """获取资源的绝对路径，兼容开发和打包环境"""
    if hasattr(sys, '_MEIPASS'):
        # 打包后的环境，用MEIPASS路径
        return os.path.join(sys._MEIPASS, relative_path)
    # 开发环境，用当前文件的父目录拼接相对路径
    return os.path.join(os.path.dirname(os.path.abspath(__file__)), relative_path)

# 使用函数获取图片路径
img_path = get_resource_path("resources/images/new.jpeg")
pixmap = QPixmap(img_path)
# 后续将pixmap设置到GUI控件即可

步骤3：重新打包 #

编辑好.spec文件后，运行下面的命令生成可执行文件：

pyinstaller your_app.spec

生成的可执行文件会在dist/your_app目录下，运行它就能正常加载图片了。

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