Ubuntu20.04安装opencv-python后运行代码报cv2未定义错误

1. 解决NameError: name 'cv2' is not defined核心错误 #

你通过import cv2 as cv将OpenCV库导入为别名cv，但代码中仍使用cv2.IMREAD_GRAYSCALE调用常量——此时当前代码的命名空间里并没有cv2这个名称，这就是报错的直接原因。

修改代码中的常量调用部分，把cv2.IMREAD_GRAYSCALE替换为cv.IMREAD_GRAYSCALE即可。示例：
原错误代码：

gray_img = cv.imread("test.jpg", cv2.IMREAD_GRAYSCALE)

修正后：

gray_img = cv.imread("test.jpg", cv.IMREAD_GRAYSCALE)

2. 可选环境验证（若修正后仍报错） #

如果修改代码后还是出现导入问题，排查Python环境一致性：

• 执行which python3和which pip3，确认两个命令的输出路径一致，避免OpenCV安装到了其他Python版本的环境中。
• 在终端运行python3 -c "import cv2 as cv; print(cv.__version__)"，若能正常输出版本号，说明安装本身没问题，问题仍在代码逻辑里。

3. 修复变量名拼写错误 #

代码中bruitelect与bruitelec拼写不一致，需统一为同一名称，否则后续会出现变量未定义或逻辑错误，建议全局替换为正确的拼写。

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