Visual Studio中OpenCV读取图像失败：无法加载JPEG文件

数据老陈

2026-7-13

问题描述

我正在尝试使用OpenCV的C++库进行实验，但在读取图像时遇到问题。以下是我的初始代码：

#include <iostream>
#include <fstream>
#include <filesystem>

#include <opencv2/imgcodecs.hpp>
#include <opencv2/highgui.hpp>
#include <opencv2/stitching.hpp>

using namespace std;
using namespace cv;


int main() {

    Mat image = imread("tiger.jpg");
    
    if (image.empty()) {
        cout << "No Image" << endl;
        return -1;
    }
    else {

        imshow("Test", image);
        waitKey(0);
        return 0;
    }

}

变量image始终为空，说明Visual Studio无法加载图像。我已将图像放入项目目录，甚至尝试使用绝对路径，但都无效。该问题近期才出现，此前读取图像一切正常。

编辑补充：
我重写了代码以验证Visual Studio是否能定位文件：

int main() {

    std::filesystem::path imagePath = "C:\\Images\\flower.jpg";

    if (std::filesystem::exists(imagePath) && std::filesystem::is_regular_file(imagePath)) {
        cv::Mat image = cv::imread(imagePath.string());

        if (!image.empty()) {
            cv::imshow("My Image", image);
            cv::waitKey(0);
        }
        else {
            std::cerr << "Error: Could not read the image." << std::endl;
        }
    }
    else {
        std::cerr << "Image file does not exist or is not a regular file." << std::endl;
    }

    return 0;

}

代码显示可以定位到文件，但仍提示图像为空。我尝试了多张不同格式的图像，均无效。该问题仅在Windows台式机上出现，Mac上无此问题，希望能得到帮助。

解决方案

针对Windows平台下OpenCV imread能找到文件但无法读取图像的问题，可按以下步骤排查：

检查OpenCV运行时依赖库
Windows下OpenCV的图像解码依赖opencv_imgcodecs4xx.dll（xx为版本号）等动态库，若该文件缺失或未被系统加载，会导致imread失败。解决方法：
1. 将OpenCV安装目录下的bin路径（如D:\opencv\build\x64\vc16\bin）添加到系统环境变量PATH中；
2. 或直接将对应版本的opencv_imgcodecs4xx.dll、opencv_core4xx.dll等核心dll复制到项目的输出目录（Debug/Release文件夹）。
核对项目与OpenCV的位数匹配
若VS项目编译目标为x86，而使用的是x64版本的OpenCV（反之亦然），会导致动态链接错误，imread无法正常工作。解决方法：
1. 在VS中右键项目→属性→配置属性→常规，将平台工具集和平台（如x64）设置为与OpenCV编译版本一致；
2. 检查项目属性中的VC++目录→包含目录、库目录，以及链接器→输入→附加依赖项，确保均对应正确位数的OpenCV路径和库文件。
验证OpenCV的图像编码支持
部分自定义编译的OpenCV可能禁用了JPEG/PNG等常用图像格式的解码器，导致无法读取图像。解决方法：
1. 替换为官方预编译的OpenCV版本；
2. 若自行编译OpenCV，需确保编译选项中WITH_JPEG、WITH_PNG、WITH_TIFF等编码相关选项已开启，重新编译后替换项目中的库文件。
排查文件权限与锁定状态
Windows系统中，若图像文件所在目录无读取权限，或文件被其他程序（如图片查看器、编辑器）锁定，也会导致imread读取失败。解决方法：
1. 右键图像文件→属性→安全，确保当前用户拥有读取权限；
2. 关闭所有可能打开该图像的程序，再运行代码测试。
检查VS工作目录配置
右键项目→属性→调试→工作目录，设置为$(OutDir)（输出目录），并将图像复制到该目录测试，排除路径解析问题。

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