OpenCV Python cv2.findContours 返回值错误解决：ValueError: too many values to unpack

OpenCV findContours返回值错误解析

近期在使用OpenCV-Python接口调用cv2.findContours()函数以提取物体轮廓时，部分开发者遇到了返回值处理问题。

参考网络教程可知，早期Python OpenCV版本的轮廓提取函数通常返回两个值：第一个是轮廓的点集，第二个是各层轮廓的索引。然而在实际调用中，程序可能抛出如下异常：ValueError: too many values to unpack (expected 2)。

该错误的根本原因在于返回值数量与接收变量不匹配。若仅使用单一变量接收返回值并检查其长度，会发现实际长度为3，表明该函数当前返回了三个值。

其中第一个返回值是被处理的原始图像，这一设计有时被视为非直观。

第二个返回值才是我们需要提取的轮廓点集。

第三个返回值则是各层轮廓的索引信息。

正确接收三个返回值的方法

正确的调用方式应包含三个接收变量，具体示例如下：

import cv2 
 
img = cv2.imread('D:\\test\\contour.jpg') 
gray = cv2.cvtColor(img,cv2.COLOR_BGR2GRAY) 
ret, binary = cv2.threshold(gray,127,255,cv2.THRESH_BINARY) 
 
contours, hierarchy = cv2.findContours(binary,cv2.RETR_TREE,cv2.CHAIN_APPROX_SIMPLE) 
cv2.drawContours(img,contours,-1,(0,0,255),3) 
 
cv2.imshow("img", img) 
cv2.waitKey(0) 

执行上述代码时，若仍按旧版两个变量的方式接收，将出现如下错误：ValueError: too many values to unpack

造成此问题的原因是OpenCV版本差异（如使用的3.2.0.7版本）。从OpenCV 3.x开始，cv2.findContours的返回值个数由两个变为三个。因此，代码应调整为接收三个返回值。

aa, ctrs, hier = cv2.findContours(im_th.copy(), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)

若无需使用第一个返回的图像变量，可使用下划线_进行占位忽略，写法如下：

_, ctrs, hier = cv2.findContours(im_th.copy(), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)

错误原因与版本差异说明

此外，关于此类错误的补充说明：

ValueError: too many values to unpack这类错误，通常由输入或输出参数数量不一致引起。

更多参考信息：

https://www.jb51.net/article/132200.htm

再次强调，若仅用一个变量接收返回值，通过len()检查会发现长度为3，这意味着函数实际返回了三个值。

第一个返回值是处理过的图像，这一特性有时令人困惑。

第二个返回值是轮廓点集，即我们主要关注的对象。

第三个返回值是各层轮廓的索引。

希望以上内容能帮助大家解决OpenCV轮廓提取中的返回值报错问题，欢迎继续支持本站获取更多技术分享。