如何将C++模型中的QPixmap传递到QML并适配多前端场景？

方案结论 #

不需要缓存到磁盘，直接传递QPixmap是满足你所有要求的最优方案，不需要走本地路径的方案，同时可以完美适配Widgets和QML两端、跨平台实现、满足启动器的即时响应性能要求。

1. 跨视图模型适配实现 #

你提到的装饰角色无法返回QIcon适配QML是正确的，我们可以通过自定义角色做兼容，不用拆分两套模型：

• 新增自定义角色CustomRole::IconRole，统一返回QPixmap类型
• 适配Widgets视图：在模型的data()函数中判断，如果请求的是Qt::DecorationRole，直接把同index的IconRole返回的QPixmap包装为QIcon返回即可，Widgets原生视图可以直接识别，不需要额外修改视图代码
• 适配QML视图：Qt 5.15及以上版本的Image组件原生支持QPixmap作为source输入，直接绑定即可：

Image {
    source: model.icon // icon为模型返回的QPixmap类型数据
    sourceSize: Qt.size(32, 32) // 按需设置尺寸，避免多余缩放开销
}

如果使用的Qt版本低于5.15，只需要把返回的QPixmap转为QImage再返回即可，QPixmap::toImage()转换开销可以忽略，QML对QImage的支持从Qt 5.0就已提供。

2. 跨平台逻辑优化 #

你现有的平台侧图标获取逻辑完全可用，只需要加一级内存缓存即可进一步提升性能：

• Linux侧：按mime type/图标名作为key缓存生成的QPixmap，不需要每次都重新查询QMimeDatabase、拉取主题图标
• macOS侧：按文件UTI/后缀作为key缓存NSImage转绘得到的QPixmap，不需要每次都调用ObjC接口重绘
• 缓存容量控制在100个以内即可覆盖绝大多数常用文件/程序图标，内存占用不到10MB，查询速度是纳秒级，完全不会拖慢搜索响应。

3. 性能保障 #

该方案完全满足键盘启动器的即时展示要求：

• QPixmap在C++和QML之间的传递是浅拷贝，没有像素数据的复制开销，传递效率极高
• 全程无磁盘IO操作，比存本地文件再传路径的方案快至少一个数量级，不会出现搜索结果加载完成后图标滞后显示的问题
• 如果存在单次返回数百条以上搜索结果的场景，可以再加懒加载逻辑：模型先返回占位用的透明/默认图标，后台线程异步加载完对应条目的图标后触发dataChanged信号刷新单个条目即可，完全不会阻塞UI线程。

什么时候需要磁盘缓存？ #

只有当你需要兼容Qt 5.0以下的极端旧版本、或者需要持久化非常用的自定义图标时才需要用到磁盘缓存，你的场景完全不需要考虑该方案。

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