【OpenCV 入门到精通 02】环境安装与第一个程序5 分钟跑通 Hello OpenCV标签OpenCV安装opencv-pythonpipcondaHello World难度⭐ 入门 |阅读时长约 45 分钟 |系列第 02/12 集前置01 认识 OpenCV |下一集03 图像入门写在前面工欲善其事必先利其器。本集帮你在 Windows / Linux / macOS 上完成 OpenCV-Python 安装并运行第一个程序——在窗口中显示一张图片。本集学习目标通过 pip/conda 安装 opencv-python理解 opencv-python 与 opencv-contrib-python 的区别运行 Hello OpenCV 验证环境了解常见安装问题及解决方案文章目录【OpenCV 入门到精通 02】环境安装与第一个程序5 分钟跑通 Hello OpenCV写在前面本集学习目标2.1 系统要求2.2 pip 安装推荐同时安装 NumPy通常自动安装2.3 conda 安装2.4 opencv-python vs opencv-contrib-pythoncontrib 额外提供的算法2.5 Hello OpenCV第一个程序读取并显示真实图片代码解剖2.6 完整验证脚本2.7 踩坑指南中文路径读取方案2.8 常见问题 FAQ2.9 本集小结2.1 系统要求组件最低推荐Python3.63.10 / 3.11内存4 GB8 GB系统Win7 / Ubuntu16 / macOS10最新稳定版2.2 pip 安装推荐# 标准版覆盖 90% 学习需求pipinstallopencv-python# 国内镜像加速pipinstallopencv-python-ihttps://pypi.tuna.tsinghua.edu.cn/simple# 锁定版本生产环境pipinstallopencv-python4.9.0.80同时安装 NumPy通常自动安装pipinstallnumpy opencv-python2.3 conda 安装conda create-nopencvpython3.11-yconda activate opencv condainstall-cconda-forge opencv# 或pipinstallopencv-python2.4 opencv-python vs opencv-contrib-python包名内容适用opencv-python核心模块学习、一般项目opencv-contrib-python核心 扩展模块需要 SIFT/SURF 等专利算法⚠️两者不可同时安装后者会覆盖前者。contrib 额外提供的算法算法模块SIFTfeatures2dSURFfeatures2dFASTfeatures2d背景减除高级算法bgsegm# 需要 SIFT 等扩展算法时pip uninstall opencv-python pipinstallopencv-contrib-python2.5 Hello OpenCV第一个程序importcv2importnumpyasnp# 创建 300×500 的蓝色画布 (BGR)imgnp.zeros((300,500,3),dtypenp.uint8)img[:](255,128,0)# 蓝色# 写文字cv2.putText(img,Hello OpenCV!,(80,160),cv2.FONT_HERSHEY_SIMPLEX,1.2,(255,255,255),2)# 显示cv2.imshow(Hello OpenCV,img)print(按任意键关闭窗口...)cv2.waitKey(0)cv2.destroyAllWindows()读取并显示真实图片importcv2 imgcv2.imread(test.jpg)ifimgisNone:print(图片读取失败请检查路径)else:print(f图片尺寸:{img.shape})cv2.imshow(Image,img)cv2.waitKey(0)cv2.destroyAllWindows()代码解剖函数作用cv2.imread()读取图片 → NumPy 数组cv2.imshow()在窗口显示cv2.waitKey(0)等待按键0无限等待cv2.destroyAllWindows()关闭所有窗口2.6 完整验证脚本OpenCV 环境验证脚本importsysdefcheck():print(*50)print(OpenCV 环境验证)print(*50)# 1. OpenCVtry:importcv2print(f✅ OpenCV{cv2.__version__})exceptImportError:print(❌ 未安装 → pip install opencv-python)returnFalse# 2. NumPytry:importnumpyasnpprint(f✅ NumPy{np.__version__})exceptImportError:print(❌ 未安装 → pip install numpy)returnFalse# 3. 创建测试图try:imgnp.zeros((100,200,3),dtypenp.uint8)img[:](0,255,0)assertimg.shape(100,200,3)print(✅ 图像创建正常)exceptExceptionase:print(f❌ 图像操作失败:{e})returnFalse# 4. 编解码try:ok,bufcv2.imencode(.png,img)decodedcv2.imdecode(buf,cv2.IMREAD_COLOR)assertdecodedisnotNoneprint(✅ 图像编解码正常)exceptExceptionase:print(f❌ 编解码失败:{e})returnFalse# 5. GUI无头环境可能跳过try:cv2.imshow(_test,img)cv2.waitKey(1)cv2.destroyAllWindows()print(✅ GUI 窗口正常)exceptException:print(⚠️ GUI 不可用服务器/无头环境正常)print(*50)print( 环境验证通过)returnTrueif__name____main__:sys.exit(0ifcheck()else1)2.7 踩坑指南问题原因解决cv2.imshow无窗口无 GUI 环境服务器用cv2.imwrite保存ImportError: cv2未安装pip install opencv-python两个包装冲突同时装了 python 和 contrib卸载后只装一个imread返回 None路径错误或中文路径检查路径用np.fromfile读中文路径pip 安装慢默认源慢加清华镜像ARM 架构安装失败无预编译包从源码编译或用 conda中文路径读取方案importcv2importnumpyasnpdefimread_chinese(path):解决 OpenCV 无法读取中文路径的问题returncv2.imdecode(np.fromfile(path,dtypenp.uint8),cv2.IMREAD_COLOR)imgimread_chinese(测试图片/风景.jpg)2.8 常见问题 FAQQ1opencv-python-headless 是什么A无 GUI 版本适合 Docker/服务器部署不含imshow等窗口功能。Q2需要单独装 OpenCV C 吗A不需要。pip install opencv-python已包含编译好的二进制。Q3OpenCV 4.9 和 4.1 教程兼容吗A核心 API 兼容个别函数参数有微调本系列以 4.x 通用写法为准。2.9 本集小结安装检查清单pip install opencv-python成功import cv2无报错Hello OpenCV 程序能弹窗显示验证脚本通过← 第01集第03集图像入门 →参考1_2 在Windows中安装OpenCV-Python