Qt5 QPixmap 載入 JPG/TIFF 失敗：缺少圖片格式插件部署指南

現象：BMP/PNG 正常，JPG/TIFF 載入失敗。原因：Qt 將圖片格式支持做為**動態插件**（qjpeg.dll、qtiff.dll 等）單獨打包，部署時必須將 imageformats 目錄隨程序一同發布。

解決步驟

1. 找到 Qt 安裝目錄下的插件：
   D:\Qt\Qt5.5.1\5.5\msvc2013\plugins\imageformats\
2. 將整個 imageformats 文件夾複製到**可執行文件同級目錄**
3. 目錄結構示例：
   

   myapp/
   ├── myapp.exe
   ├── Qt5Core.dll
   ├── ...
   └── imageformats/
       ├── qjpeg.dll
       ├── qtiff.dll
       └── ...
   

驗證方法

qDebug() << QImageReader::supportedImageFormats();
// 應包含 "jpg", "jpeg", "tiff", "tif" 等

常見坑

• 只複製 dll 不複製目錄結構 → 插件加載失敗
• Debug/Release 混用 → 需對應版本插件
• 靜態編譯 Qt 可避免此問題，但編譯耗時極長

官方部署工具 windeployqt.exe 可自動收集所有依賴插件，強烈推薦使用。