安装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
相关产品推荐
相关产品推荐

