Ubuntu服务器下opencv-python与rapid_latex_ocr依赖冲突致导入错误求助

核心原因 #

rapid_latex_ocr的依赖声明中包含opencv-python，安装时会自动将其安装到虚拟环境，与已存在的opencv-python-headless产生包冲突，导致cv2导入时无法正确加载依赖库。

解决步骤 #

• 彻底卸载冲突的opencv包

  pip uninstall -y opencv-python opencv-python-headless
  

• 安装适配服务器无图形界面环境的headless版本

  pip install opencv-python-headless
  

• 安装rapid_latex_ocr并跳过其opencv依赖

  pip install rapid_latex_ocr --no-deps
  

  注：如果rapid_latex_ocr还有其他必需依赖（如numpy、torch等），需手动安装这些依赖包。
• 验证修复效果
  激活虚拟环境后执行以下代码：

  import cv2
  print(cv2.__version__)
  

  能正常打印版本号则说明问题解决。

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