已安装cmake、dlib、face-recognition但提示face-recognition模块找不到怎么办

1 优先检查解释器匹配问题 #

• 进入PyCharm 【文件】→【设置】→【项目:当前项目名称】→【Python解释器】，记录当前绑定的解释器路径
• 打开你平时执行pip命令的终端，运行pip show dlib，查看输出的Location字段对应的库路径，确认是否和PyCharm解释器的第三方库路径一致
• 若路径不匹配：直接在PyCharm解释器界面点击「+」按钮，搜索dlib、cmake、face-recognition完成安装，不要使用外部终端的pip命令

2 版本兼容性校验 #

• dlib对Python3.11及以上版本的预编译包支持不完善，若你当前使用Python3.11+，建议降级到Python3.8/3.9版本后重新安装所有依赖
• 若你使用虚拟环境，必须先激活对应虚拟环境，再执行pip安装命令，避免包安装到全局环境导致虚拟环境无法识别

3 dlib安装有效性校验 #

• 打开PyCharm底部的「终端」面板（会自动激活当前项目绑定的解释器/虚拟环境），执行python进入交互模式，输入import dlib
  • 若执行无报错，说明dlib本身安装正常，属于PyCharm索引异常：右键点击项目根目录，选择【将目录标记为】→【源根】，再点击【文件】→【无效缓存并重启】，等待索引重建完成即可
  • 若执行报错，运行pip uninstall -y dlib cmake face-recognition后重新按顺序安装：pip install cmake → pip install dlib → pip install face-recognition

4 最终验证 #

依赖修复完成后，在PyCharm终端执行python -c "import face_recognition;print('模块加载成功')"，输出正常提示则问题解决

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