You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

安装OpenCV时出现FileNotFoundError缺少scripts/__init__.py如何解决

报错原因
  • PyCharm内置可视化包管理器的路径解析异常:如果当前使用的Python环境路径、项目路径包含中文、空格或特殊字符,PyCharm调用pip安装包时无法正确定位到环境对应scripts目录,就会抛出找不到scripts/__init__.py的错误
  • pip版本过低:旧版本pip的依赖解析、目录生成逻辑存在缺陷,安装OpenCV的预编译包过程中容易出现文件定位失败问题
  • 虚拟环境损坏:当前使用的虚拟环境在创建时就出现异常,缺失scripts目录下的必要初始化文件,和OpenCV安装本身无直接关联
  • 写入权限不足:Windows下PyCharm未以管理员身份运行,或是macOS/Linux下当前用户没有Python环境目录的写入权限,安装过程中无法生成所需文件就会触发该报错
解决方法
  • 升级pip到最新版本
    打开PyCharm底部的Terminal终端面板,执行对应命令:
    Windows环境:python -m pip install --upgrade pip
    macOS/Linux环境:python3 -m pip install --upgrade pip
  • 直接通过终端命令安装OpenCV,不要使用PyCharm的可视化包安装界面
    安装基础版本执行:pip install opencv-python
    安装带扩展模块的完整版执行:pip install opencv-contrib-python
    需要安装指定版本可使用:pip install opencv-python==4.5.5.62(可自行替换为目标版本号)
  • 检查路径合规性
    确认你的Python解释器安装路径、项目存储路径都不包含中文、空格以及!@#$%^&*这类特殊字符,如有则修改路径后重新操作
  • 处理权限异常
    Windows系统:右键点击PyCharm图标,选择「以管理员身份运行」后再执行安装操作
    macOS/Linux系统:安装命令前增加sudo获取权限,示例:sudo pip3 install opencv-python,输入用户密码后继续安装即可
  • 修复损坏的虚拟环境
    删除当前项目的旧虚拟环境,在PyCharm的解释器设置中重新创建一个干净的虚拟环境,再按上述步骤安装OpenCV即可

内容的提问来源于stack exchange,提问作者ucoder21

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.26 11:06:03