Django项目引入fontawesomefree时报ModuleNotFoundError错误如何解决

问题原因 #

出现ModuleNotFoundError: No module named 'fontawesomefree'的核心原因是当前运行Django项目的Python解释器环境中，没有成功安装fontawesomefree依赖包，常见触发场景如下：

• 仅在requirements.txt中声明了依赖，没有执行实际的安装命令
• 项目使用了虚拟环境，依赖包被安装到全局Python环境，未安装到当前激活的虚拟环境中
• 安装时使用的pip版本和项目运行的Python版本不匹配（比如用pip安装对应Python2的依赖，项目实际用Python3运行）
• 安装过程中出现网络中断、权限报错等问题，导致包未完成安装

解决步骤 #

1. 先激活项目对应的虚拟环境（如果使用了虚拟环境），执行以下命令重新安装依赖：

pip install -r requirements.txt

如果是Python3环境且pip和pip3分离，执行：

pip3 install -r requirements.txt

2. 安装完成后执行以下命令验证包是否安装成功，确认输出包含fontawesomefree==5.15.4即可：

pip freeze | grep fontawesomefree

3. 如果验证成功后仍然报错，检查项目运行的Python解释器路径是否和pip对应的Python路径一致，执行以下命令对比路径：

# 查看项目使用的Python路径
which python
# 查看pip对应的Python路径
pip -V

如果路径不一致，直接使用项目对应的Python解释器执行安装命令即可：

<你的项目Python解释器完整路径> -m pip install fontawesomefree==5.15.4

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