QT中的资源树 - 技术栈

QT中的资源树

镜中月ss2026-03-26 9:24

资源树

QT中的资源树，实际分为两种完全不同的东西：
静态资源树： 也就是Qt 内置的 .qrc 资源系统
动态资源树： 运行时加载的界面树形控件，界面就类似于文件浏览器、资源管理器

我们在软件开发过程中，提到的资源树，大多数是第二种，需要我们实现这样一种对资源管理的功能。

静态资源树

什么是静态资源树？

静态资源树，也叫做QT资源系统，这是QT中内置的管理资源的方式。它可以将应用程序所需文件（如图片、字体、QML 文件、翻译文件、配置文件等）嵌入到可执行文件中。

简单来说，就是把你需要的的图片 / 文件，编译成二进制代码，然后嵌入 exe 程序内部，这样exe运行时直接从内存读取，不走硬盘

优点：

编译进程序，发布时不需要附带资源文件
无磁盘 IO，加载速度极快
不需要线程（主线程直接用）

缺点：

资源修改后必须重新编译
不适合大文件（如视频、大型素材）

应该如何使用？

创建 qrc 资源文件

Qt Creator → 新建项目或文件 → 选择新建Qt Resource File → 命名（如resources.qrc）

添加文件

右键新建的.qrc文件 → Add Prefix（是添加前缀，一般直接将前缀设置为 /）→ 在新添加的前缀下面，添加自己的资源文件

在代码中访问资源

固定路径格式：qrc:前缀/文件名

举例说明

复制代码

Window{
    height: 400
    width:800
    visible: true

    Image {
        source: "qrc:/images/1.png"   //资源路径
        anchors.fill: parent
        fillMode: Image.PreserveAspectFit
    }

}

首先在QT中添加了test.qrc，由代码可以很明显看到 .qrc 文件的名称与资源访问路径没有直接关系。所以我们在使用的时候不需要考虑 .qrc 文件。然后我们的前缀是 / ，不是 /images 。为什么有 images？因为我是将图片放在同一个目录下，这样开发比较方便，毕竟实际开发过程中，肯定会有很多不同的资源。所以完整的路径组成就是：qrc:前缀（/）+文件路径（images/1.png）