Qt中QImage加载图片正常但无法保存的问题求助

问题描述 #

我希望在Qt中使用QImage加载并保存图片，目前能够正常加载图片，但无法保存图片。为此我编写了一段测试代码：使用画图工具制作了一张简单的png测试文件，放在项目同目录下，代码如下：

#include <QImage>
#include <iostream>

int main(){
    QImage image;
    image.load("test.png");

    if (image.isNull()){
        std::cout << "ERROR!\n";
    }
    else{
        std::cout << "IMAGE LOADED!\n";
    }

    image.save("test1.png");

    return 0;
}

运行程序时，应用输出显示‘IMAGE LOADED!’，但检查目标文件夹并未生成test1.png。请问如何实现图片保存？我遗漏了什么？

解决要点 #

• 检查图像格式插件：QImage的保存功能依赖Qt对应的图像格式插件（比如PNG格式需要qpng插件）。
  • 运行程序的目录下，需要存在imageformats文件夹，里面包含对应平台的png插件：Windows为qpng.dll，Linux为libqpng.so，macOS为libqpng.dylib。
  • 可以添加代码打印支持的格式，确认是否包含PNG：

    #include <QImageWriter>
    // ...
    qDebug() << QImageWriter::supportedImageFormats();
    

• 验证保存路径：
  • 直接使用相对路径时，文件会保存到程序的当前工作目录，而非项目源码目录。可以添加代码查看当前路径：

    #include <QDir>
    // ...
    std::cout << "当前工作目录：" << QDir::currentPath().toStdString() << std::endl;
    

  • 优先使用绝对路径测试，比如image.save("C:/temp/test1.png")（Windows）或image.save("/tmp/test1.png")（Linux/macOS），排除路径权限或位置混淆问题。
• 捕获save函数返回值：save()函数会返回布尔值表示保存是否成功，一定要添加判断排查问题：

  bool result = image.save("test1.png");
  if (!result) {
      std::cout << "图片保存失败！" << std::endl;
  }
  

• 确认项目配置：
  • qmake项目：确保.pro文件中添加了QT += gui（QImage属于Qt Gui模块）。
  • CMake项目：确保链接了Qt的Gui模块，比如在CMakeLists.txt中添加：

    target_link_libraries(your_project_name Qt::Gui)
    

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