Qt学习笔记4：使用资源文件

最新推荐文章于 2026-07-06 18:10:46 发布

原创最新推荐文章于 2026-07-06 18:10:46 发布 · 922 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

收录于

Qt学习笔记

本文详细介绍了在Qt项目中如何添加、管理及使用资源文件，特别是针对图片资源的操作步骤。通过新建Qt资源文件，添加资源前缀，并在代码中利用+QRC://+前缀来访问和使用这些资源，实现程序对资源文件的有效管理。

Qt中需要加载外部资源文件时，如何操作？这里以常用图片资源作为实例，记录完整的使用过程。

添加资源文件

新建空项目，取名qresource，文件列表如下图所示：
添加资源文件，在项目名称上右键选择添加新文件，依次选择Qt - Qt Resource File - Choose
填写名称和录像，依次确认后，创建成功。

资源文件管理

资源文件管理器
新建资源文件管理器成功后，可以看到工程文件列表新增了资源一列，如图

工程配置文件末尾新增了RESOURCES += image.qrc。
选择image.qrc，右键Open in Editor进入资源管理界面

可以通过资源管理器添加、删除、修改资源文件。
添加资源文件
添加资源文件，首先需要添加前缀，前缀作为访问资源文件的一部分。例如，添加前缀/image。
在前缀中添加文件，选择需要添加的文件，确认后将文件添加到qt工程中，可以直接在qt工程中打开文件。

使用资源文件

在资源添加成功之后，就可以随意使用资源文件了，使用时采用: + 前缀 + 文件名的格式，如创建图标QIcon(":/image/home.png")、加载图片image.load(":/image/home.png");等，实例如下所示：

#include "widget.h"
#include "ui_widget.h"

#include <QIcon>
#include <QImage>
#include <QPixmap>

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);
    setWindowTitle("qresource");
    setWindowIcon(QIcon(":/image/home.png"));

    QImage image;
    image.load(":/image/home.png");

    QPixmap pixmap = QPixmap::fromImage(image);
    ui->label->setPixmap(pixmap);
}

Widget::~Widget()
{
    delete ui;
}