QResource 不支持运行时动态添加图片，因其资源在编译期由 rcc 工具嵌入二进制且只读；可行替代方案为重新构建 .qrc 或直接使用文件路径加载。
Qt 的 QResource 系统本身不支持运行时动态添加图片文件——资源必须在编译期打包进可执行文件，QResource 只能读取已注册的资源，不能写入或追加。 想“动态添加”，本质只有两种可行路径：重新生成并加载新的 .qrc 文件（需重新构建），或绕过资源系统、直接用文件路径加载（失去资源封装优势）。
为什么不能在程序运行时往 QResource 里 add 图片
QResource 是只读接口，背后对应的是编译时由 rcc 工具将 .qrc 编译成 C++ 代码后嵌入二进制的数据段。它没有提供任何 addFile()、registerResource() 或类似 API。试图调用不存在的方法会编译失败或静默忽略。
- 常见错误现象：
QResource::registerResource()在 Qt 6 中已被移除；Qt 5.15 之前虽有该函数，但仅支持注册外部.rcc文件（不是单个图片），且要求该文件由rcc预先编译，不是原始 PNG/JPG - 误以为“右键 qrc → Open in Editor → Add Files”是运行时操作：这是 IDE 编辑行为，修改的是源
.qrc文件，必须重新构建项目才能生效 - 混淆
QPixmap::load()路径：":/xxx.png"这种写法依赖编译时已注册的前缀和文件名，运行时改路径但没重新编译，必然load()失败返回 false
正确添加图片到资源系统的标准流程
所有操作都在开发阶段完成，最终产物是静态链接进程序的二进制资源：
- 把图片（如
icon.png）复制到项目目录下某个子文件夹（例如resources/images/），避免路径含中文或空格 - 右键项目 → Add New… → Qt → Qt Resource File → 命名为
resources.qrc - 右键刚建的
resources.qrc→ Open in Editor - 点击 Add Prefix，前缀建议填
/（最简，避免路径拼错）；也可用/img、/icons等语义化前缀 - 点击 Add Files，定位到你放图片的文件夹，选中文件 → OK
- 保存
resources.qrc，确保.pro文件里有RESOURCES += resources.qrc（Qt Creator 通常自动加）；CMake 项目需在CMakeLists.txt中显式qt_add_resources - 重新构建整个项目（Clean + Rebuild 更可靠），否则 UI 设计器或代码中可能仍找不到资源
运行时“模拟动态”的实用替代方案
如果真需要从外部加载新图片（比如用户拖入 PNG、从网络下载），就别走 QResource，直接用文件系统路径：
-
QPixmap和QImage支持直接加载本地路径：pixmap.load("/tmp/downloaded.png")，只要路径合法、有读权限 - 用
QDir::setCurrent()或绝对路径管理外部资源目录，避免硬编码；配合QStandardPaths存放用户数据更规范 - 若仍想统一资源访问风格，可封装一个简易资源管理器类，内部维护
QHash<qstring qpixmap></qstring>，按需从磁盘加载并缓存，但注意内存和线程安全 - 警告：用
setStyleSheet("border-image: url(/tmp/x.png)")时，Qt 不会自动监听文件变化，图片更新需手动触发setStyleSheet重设
真正容易被忽略的一点：资源路径里的斜杠方向。Windows 下用 :/img/icon.png 没问题，但如果你在 .qrc 编辑器里手输路径用了反斜杠（:\img\icon.png），rcc 会静默失败，图片不进资源——所有路径必须用正斜杠，无论平台。
