如何在Python中用try-except捕获CV2文件加载异常

核心问题：为什么之前的异常捕获没用？ #

cv2.imread的逻辑是：文件不存在时返回None，不会抛出cv2.error，只有文件存在但解码失败（比如损坏的PNG）才会触发cv2相关异常。你之前抓错了异常类型，自然无效。

方案一：先检查文件存在性，再判断加载结果 #

这是最直接可靠的方式，先通过os.path.exists确认文件存在，再加载后判断返回值是否为None：

import cv2
import os

# 替换成你的编号范围
for num1 in range(1, 6):
    for num2 in range(20, 31):
        filename = f"name_{num1}_section_{num2}.png"
        # 第一步：检查文件是否存在
        if not os.path.exists(filename):
            print(f"跳过不存在的文件: {filename}")
            continue
        # 第二步：加载灰度图（计算黑色像素更高效）
        img = cv2.imread(filename, cv2.IMREAD_GRAYSCALE)
        # 第三步：确认加载成功
        if img is None:
            print(f"文件损坏或无法解析: {filename}")
            continue
        # 计算黑色像素占比（灰度图中黑色为0）
        total_pixels = img.size
        black_pixels = (img == 0).sum()
        black_ratio = black_pixels / total_pixels
        print(f"{filename} 黑色像素占比: {black_ratio:.2%}")

方案二：批量筛选有效文件，避免无效循环 #

如果编号范围很大，嵌套循环会做很多无用功，可以先遍历目录，筛选出符合命名规则的文件再处理：

import cv2
import os
import re

# 匹配命名格式的正则表达式
file_pattern = re.compile(r"name_(\d+)_section_(\d+)\.png")

for filename in os.listdir("."):
    match = file_pattern.match(filename)
    if not match:
        continue  # 跳过不符合格式的文件
    # 提取编号（如果需要用到num1、num2的话）
    num1, num2 = match.groups()
    # 加载并计算
    img = cv2.imread(filename, cv2.IMREAD_GRAYSCALE)
    if img is None:
        print(f"无法加载文件: {filename}")
        continue
    total_pixels = img.size
    black_pixels = (img == 0).sum()
    black_ratio = black_pixels / total_pixels
    print(f"{filename} (num1={num1}, num2={num2}) 黑色像素占比: {black_ratio:.2%}")

方案三：针对特殊情况的异常捕获 #

如果遇到文件存在但cv2解码失败的场景，可以把加载逻辑放进try块，捕获通用异常：

import cv2
import os

for num1 in range(1, 6):
    for num2 in range(20, 31):
        filename = f"name_{num1}_section_{num2}.png"
        try:
            img = cv2.imread(filename, cv2.IMREAD_GRAYSCALE)
            if img is None:
                raise ValueError("图片加载失败")
            # 计算占比
            total_pixels = img.size
            black_pixels = (img == 0).sum()
            black_ratio = black_pixels / total_pixels
            print(f"{filename} 黑色像素占比: {black_ratio:.2%}")
        except (FileNotFoundError, ValueError) as e:
            print(f"处理 {filename} 出错: {str(e)}")

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