Windows下编译带OPENCV_ENABLE_NONFREE的OpenCV4.5.5后，SURF在Anaconda环境外可用但环境内报错的问题求助

这个问题我之前踩过一模一样的坑，核心原因是Anaconda环境自带的OpenCV包和你手动编译的版本冲突了：环境里默认安装的opencv-python或opencv-contrib-python并不包含nonfree模块（SURF就属于这类受专利保护的模块），而且Python会优先加载环境内的包，导致你辛苦编译的带OPENCV_ENABLE_NONFREE的版本根本没被调用到。

具体解决步骤 #

1. 清理Anaconda环境中的默认OpenCV包 #

首先激活你的Anaconda环境，然后检查并卸载自带的OpenCV包：

• 打开命令提示符，激活环境：

  conda activate 你的环境名
  

• 查看当前环境的OpenCV相关包（Windows下用findstr，Linux/macOS用grep）：

  pip list | findstr opencv
  

• 如果输出里有opencv-python、opencv-contrib-python或类似包，全部卸载：

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

  卸载完成后再用pip list | findstr opencv确认没有残留。

2. 让Anaconda环境指向你编译的OpenCV版本 #

接下来要让环境识别到你自己编译的OpenCV，有两种方式可选：

临时生效法（仅当前会话有效）

在你的Python代码开头添加路径，强制加载编译版OpenCV：

import sys
# 替换成你编译的OpenCV安装目录下的site-packages路径
sys.path.append("C:/opencv-build/install/Lib/site-packages")
import cv2

# 测试SURF
surf = cv2.xfeatures2d.SURF_create(400)

永久生效法（环境每次激活都会加载）

1. 找到你的Anaconda环境的site-packages目录，比如：

   C:\Users\你的用户名\anaconda3\envs\你的环境名\Lib\site-packages
   

2. 在这个目录下新建一个名为opencv.pth的文本文件，里面一行写入你编译的OpenCV的site-packages路径，比如：

   C:\opencv-build\install\Lib\site-packages
   

3. 保存文件后，下次激活环境时Python会自动加载这个路径。

3. 验证是否成功 #

激活环境后打开Python控制台，执行以下命令：

import cv2
print(cv2.__version__)  # 应该输出4.5.5
print(cv2.xfeatures2d.SURF_create)  # 能输出函数对象说明模块可用

额外注意事项 #

• 确认你编译OpenCV时，CMAKE的OPENCV_ENABLE_NONFREE选项确实被勾选，且编译安装过程没有报错；
• 如果编译时指定了自定义安装路径，一定要确保路径填写正确，不要出现拼写错误或斜杠方向错误（Python里可以用正斜杠/或者双反斜杠\\）。

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