桌面应用 / 系统课时

用 Qt 资源系统打包文件

用 Qt 资源系统打包文件

本篇介绍 Qt 6 的资源系统,通过 .qrc 文件将图片、图标等静态资源编译进应用程序,使程序不依赖外部文件路径也能访问这些内容。

学习目标

  • 理解 Qt 资源系统解决的问题和适用场景。
  • 掌握 .qrc 文件的定义方式和资源路径规则。
  • 能够在 Qt 程序中加载内置图片或图标资源。

为什么需要 Qt 资源系统

桌面程序通常需要携带图标、背景图片、翻译文件或默认配置。如果直接读取磁盘文件,发布时需要保证目录结构一致,否则程序可能因为找不到文件而运行失败。

Qt 资源系统会在构建阶段把指定文件转换为应用内部资源。运行时通过统一的资源路径访问,不需要关心资源实际存放位置。

资源系统适合以下内容:

  • 应用图标。
  • 界面图片。
  • 默认模板文件。
  • 内置样式表。

用户生成的数据、日志文件等动态内容不应该放入资源系统。

创建 qrc 资源文件

在 Qt 项目中创建资源文件,例如 resources.qrc:

xml
<RCC>
    <qresource prefix="/">
        <file>images/logo.png</file>
    </qresource>
</RCC>

prefix 定义资源路径前缀。上面的配置会让图片通过 /images/logo.png 访问。

如果项目使用 CMake,需要将资源文件加入构建配置。

cmake
cmake_minimum_required(VERSION 3.16)
project(ResourceDemo)

find_package(Qt6 REQUIRED COMPONENTS Widgets)

qt_add_executable(ResourceDemo
    main.cpp
    resources.qrc
)

target_link_libraries(ResourceDemo PRIVATE Qt6::Widgets)

预期结果

text
CMake 配置完成后,resources.qrc 中的资源会被编译进应用程序。

在代码中访问资源

Qt 资源路径以冒号开头,例如 :/images/logo.png。

cpp
#include <QApplication>
#include <QLabel>
#include <QPixmap>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QLabel label;
    QPixmap image(":/images/logo.png");
    label.setPixmap(image);
    label.show();

    return app.exec();
}

预期结果

text
窗口中显示 resources.qrc 内置的 logo.png 图片。

理解资源路径和磁盘路径的区别

Qt 资源路径不是操作系统真实文件路径。例如:

类型 示例 是否依赖外部文件
磁盘路径 <PATH>/logo.png 是
Qt 资源路径 :/images/logo.png 否

资源系统隐藏了实际存储位置,因此部署后的应用更加稳定。

资源系统的使用边界

资源文件会随着程序一起发布,但修改资源通常需要重新构建应用。因此它不适合保存运行期间变化的数据。

例如用户头像、下载文件、编辑内容应该保存到普通文件系统中;应用自带的默认图片和图标则适合放入资源系统。

正确区分静态资源和动态数据,可以避免资源体积增长和更新困难的问题。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

用 Qt 资源系统打包文件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通