OpenCV cv2.setMouseCallback回调修改外部变量报UnboundLocalError如何解决

报错根源 #

Python 作用域判定规则：只要内层函数内存在对某个变量的赋值操作，就会默认将该变量识别为当前函数的局部变量，不会向上查找外层作用域的同名变量。

你在回调函数get_pixel中写了b_min = min(b, b_min)这类赋值语句，Python会直接把b_min当成回调的内部局部变量，但执行min(b, b_min)的瞬间，这个局部变量还没有完成初始化赋值，因此触发UnboundLocalError。

解决方案 #

方案1：使用nonlocal关键字（最适配当前嵌套函数结构） #

nonlocal的作用是显式告知Python：标记的变量不属于当前内层函数的局部作用域，需要向上查找嵌套的非全局作用域中的同名变量绑定。
修改后的可运行代码：

import cv2

def track_ground():
    b_min, g_min, r_min = 255, 255, 255
    b_max, g_max, r_max = 0, 0, 0
    
    def get_pixel(event, x, y, flags, param):
        # 声明以下6个变量来自外层嵌套作用域，不是回调的内部局部变量
        nonlocal b_min, g_min, r_min, b_max, g_max, r_max
        if event == cv2.EVENT_MOUSEMOVE:
            # 修正原代码的像素索引错误：OpenCV图像维度为(高度, 宽度, 通道)
            # 鼠标返回的x为水平列坐标，y为垂直行坐标，正确索引为img[y, x]
            b, g, r = img[y, x]
            b_min = min(b, b_min)
            g_min = min(g, g_min)
            r_min = min(r, r_min)
            b_max = max(b, b_max)
            g_max = max(g, g_max)
            r_max = max(r, r_max)
    
    img = cv2.imread('data/my_image.jpg')
    cv2.namedWindow('image')
    cv2.setMouseCallback('image', get_pixel)
    while True:
        cv2.imshow('image', img)
        if cv2.waitKey(1) & 0xFF == ord('q'):
            break
    cv2.destroyAllWindows()
    
    print('min:', b_min, g_min, r_min)
    print('max:', b_max, g_max, r_max)
    return (b_min, g_min, r_min), (b_max, g_max, r_max)

注：原代码中img[x, y]的索引写反了，若不修正会导致取到的像素值完全错位，采集到的RGB范围会完全不符合实际区域的颜色。

方案2：使用可变容器存储最值参数（灵活性更高） #

可变对象（字典、列表等）的内部元素修改操作，不会触发Python的局部变量判定——此时你没有对容器变量本身做重新赋值，仅修改其内部存储的内容，Python会自动向上查找外层的容器变量绑定。
示例实现：

import cv2

def track_ground():
    # 用字典统一存储RGB最值参数
    range_stats = {
        'b_min': 255, 'g_min': 255, 'r_min': 255,
        'b_max': 0, 'g_max': 0, 'r_max': 0
    }
    
    def get_pixel(event, x, y, flags, param):
        if event == cv2.EVENT_MOUSEMOVE:
            b, g, r = img[y, x]
            # 直接修改字典内部元素，无需额外作用域声明
            range_stats['b_min'] = min(b, range_stats['b_min'])
            range_stats['g_min'] = min(g, range_stats['g_min'])
            range_stats['r_min'] = min(r, range_stats['r_min'])
            range_stats['b_max'] = max(b, range_stats['b_max'])
            range_stats['g_max'] = max(g, range_stats['g_max'])
            range_stats['r_max'] = max(r, range_stats['r_max'])
    
    img = cv2.imread('data/my_image.jpg')
    cv2.namedWindow('image')
    cv2.setMouseCallback('image', get_pixel)
    while True:
        cv2.imshow('image', img)
        if cv2.waitKey(1) & 0xFF == ord('q'):
            break
    cv2.destroyAllWindows()
    
    print('min:', range_stats['b_min'], range_stats['g_min'], range_stats['r_min'])
    print('max:', range_stats['b_max'], range_stats['g_max'], range_stats['r_max'])
    return (range_stats['b_min'], range_stats['g_min'], range_stats['r_min']), \
           (range_stats['b_max'], range_stats['g_max'], range_stats['r_max'])

该方案的扩展优势：如果后续要把回调函数从嵌套结构中抽离（比如写成全局函数），可以直接把range_stats作为param参数传给cv2.setMouseCallback，不需要调整作用域逻辑。

不适用的方案提醒 #

• 不要使用global关键字声明这些变量：因为上述最值变量是定义在track_ground函数内部的，不属于全局作用域，global会让Python去全局作用域查找同名变量，反而会引入新的不匹配问题。

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