Windows10+PyCharm环境下OpenCV的Aruco包安装失败求助

核心结论 #

不需要单独安装aruco第三方包，OpenCV的opencv-contrib-python版本已经内置了完整的ArUco模块，单独安装第三方aruco包会引发版本冲突和编译依赖问题。

分步解决方案 #

1. 清理冲突依赖
   先卸载所有可能冲突的包，确保环境干净：

   pip uninstall -y opencv-python opencv-contrib-python aruco
   

   （如果使用Python3.6且默认pip指向其他版本，替换为pip3）

2. 匹配Python与依赖版本
   根据你使用的Python版本选择对应命令：

   • Python 3.6：numpy 1.23+不再兼容Python3.6，需指定低版本：

     pip install numpy==1.21.6 opencv-contrib-python==4.5.5.62
     

   • Python 3.10：直接安装兼容的最新版本：

     pip install numpy opencv-contrib-python
     

3. PyCharm解释器配置验证

   • 打开PyCharm，进入File > Settings > Project: [你的项目名] > Python Interpreter
   • 确认当前选中的解释器是你配置的Python版本（3.6/3.10）
   • 检查列表中是否有opencv-contrib-python和对应版本的numpy，缺失则点击+搜索安装

4. 验证ArUco模块可用性
   创建测试代码运行：

   import cv2
   from cv2 import aruco
   
   # 生成测试ArUco标记
   dict_aruco = aruco.Dictionary_get(aruco.DICT_6X6_250)
   marker = aruco.drawMarker(dict_aruco, 10, 300)
   cv2.imwrite("test_aruco_marker.png", marker)
   print("ArUco模块加载成功")
   

   若成功生成图片并打印提示，说明安装生效。

错误原因说明 #

• 单独执行pip install aruco时，该第三方包需要编译C扩展，因此依赖Microsoft Visual C 14.0构建工具，且与官方OpenCV包存在兼容性冲突。
• Python3.6安装numpy1.23.x时，报错AttributeError: module 'os' has no attribute 'add_dll_directory'，因为os.add_dll_directory是Python3.8新增的API，numpy1.23+已不再兼容Python3.6。

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