macOS安装DeepFace后仍提示‘module deepface not found’错误求助

可能的原因 #

• Anaconda环境未激活，导致pip安装的DeepFace包不在当前运行的Python环境中
• macOS系统默认Python与Anaconda环境的Python路径冲突，运行python api.py时调用了系统默认Python而非Anaconda环境的解释器
• pip安装时未关联到Anaconda环境，包被安装到了系统Python路径下
• 开发工具（如IDE）的Python解释器未配置为Anaconda环境

解决步骤 #

1. 确保激活正确的Anaconda环境 #

打开终端，执行以下命令激活你的Anaconda环境（替换为你实际的环境名，base环境直接用conda activate base）：

conda activate your_env_name

激活后，重新安装DeepFace，确保包安装在当前环境：

pip install deepface

验证安装结果：

pip list | grep deepface

如果能看到DeepFace及其版本，说明安装成功。

2. 确认Python路径与环境匹配 #

激活环境后，执行以下命令查看当前Python路径：

which python

输出路径应指向Anaconda环境目录（例如/Users/xxx/opt/anaconda3/envs/your_env_name/bin/python）。

如果运行python api.py仍报错，直接使用该完整路径运行脚本：

/path/to/your/anaconda/python api.py

3. 强制使用当前环境的pip安装 #

避免系统pip干扰，激活环境后用python -m pip执行安装：

python -m pip install deepface

4. 检查开发工具的解释器配置 #

如果使用VSCode、PyCharm等IDE运行脚本：

• 打开项目设置，找到Python解释器选项
• 选择已激活的Anaconda环境对应的Python解释器
• 重启IDE后重新运行api.py

5. 排查环境变量冲突 #

如果上述方法无效，检查终端的环境变量，确保Anaconda的路径优先级高于系统Python：
执行以下命令查看PATH：

echo $PATH

Anaconda环境的bin目录应排在系统Python路径（如/usr/bin）之前。若不是，可在~/.zshrc或~/.bash_profile中添加Anaconda路径（替换为你的实际路径）：

export PATH="/Users/xxx/opt/anaconda3/envs/your_env_name/bin:$PATH"

保存后执行source ~/.zshrc（或source ~/.bash_profile）生效。

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