Python使用OpenCV读取图片返回None排查及解决技巧

import cv2

img = cv2.imread("test.jpg")
print(img)  # 输出 None 就是读取失败
print(type(img))  # <class 'NoneType'> 代表读取失败

# Windows 绝对路径
img = cv2.imread("D:/project/img/test.jpg")  
# 或者用反斜杠，但必须加 r 转义
img = cv2.imread(r"D:\project\img\test.jpg")

import cv2
import os

# 获取当前 .py 文件的绝对路径
base_path = os.path.dirname(os.path.abspath(__file__))
# 拼接图片路径
img_path = os.path.join(base_path, "img", "test.jpg")

img = cv2.imread(img_path)

img = cv2.imread("D:/测试文件夹/图片.jpg")  # 直接返回 None

import cv2
import numpy as np

# 先用 imdecode 读取，支持中文路径
def cv_imread(file_path):
    # 读取图片字节数据
    cv_img = cv2.imdecode(np.fromfile(file_path, dtype=np.uint8), cv2.IMREAD_COLOR)
    return cv_img

# 使用这个函数代替 cv2.imread
img = cv_imread("D:/测试文件夹/图片.jpg")

chmod 644 你的图片路径

# 不推荐，缺少依赖库
pip install opencv-python

# 完整版本，包含所有依赖（解决大部分底层读取失败）
pip install opencv-contrib-python

import cv2
import os

def check_image_read(img_path):
    # 1. 判断文件是否存在
    if not os.path.exists(img_path):
        print("错误：文件不存在！")
        return None
    
    # 2. 判断是否是文件
    if not os.path.isfile(img_path):
        print("错误：这不是一个文件！")
        return None
    
    # 3. 读取图片
    img = cv2.imread(img_path)
    
    # 4. 判断是否读取成功
    if img is None:
        print("错误：cv2.imread 读取失败！")
        print("可能原因：中文路径/图片损坏/格式不支持/权限不足")
        # 尝试用中文路径兼容方案读取
        try:
            import numpy as np
            img = cv2.imdecode(np.fromfile(img_path, dtype=np.uint8), cv2.IMREAD_COLOR)
            if img is not None:
                print("已自动用中文路径方案修复！")
        except:
            pass
    else:
        print("图片读取成功！图片形状：", img.shape)
    return img

# 测试
if __name__ == "__main__":
    # 替换成你的图片路径
    image_path = "test.jpg"  
    check_image_read(image_path)