Windows下运行wordcloud报错：_imagingft C模块未安装求助

AI 小北

2026-8-15

问题描述

在Windows系统中使用Python生成词云，已通过pip install wordcloud安装wordcloud库，运行官方示例代码后出现ImportError: The _imagingft C module is not installed错误。

环境信息：

PIL版本：9.2.0
Python版本：3.7.13 (64位，Anaconda环境)

错误追踪信息：

Traceback (most recent call last):
  File "C:\Users\XXXXX\test_wordcloud.py", line 13, in <module>
    wordcloud = WordCloud().generate(text)
  File "C:\Anaconda3\lib\site-packages\wordcloud\wordcloud.py", line 639, in generate
    return self.generate_from_text(text)
  File "C:\Anaconda3\lib\site-packages\wordcloud\wordcloud.py", line 621, in generate_from_text
    self.generate_from_frequencies(words)
  File "C:\Anaconda3\lib\site-packages\wordcloud\wordcloud.py", line 454, in generate_from_frequencies
    max_font_size=self.height)
  File "C:\Anaconda3\lib\site-packages\wordcloud\wordcloud.py", line 503, in generate_from_frequencies
    font = ImageFont.truetype(self.font_path, font_size)
  File "C:\Anaconda3\lib\site-packages\PIL\ImageFont.py", line 959, in truetype
    return freetype(font)
  File "C:\Anaconda3\lib\site-packages\PIL\ImageFont.py", line 956, in freetype
    return FreeTypeFont(font, size, index, encoding, layout_engine)
  File "C:\Anaconda3\lib\site-packages\PIL\ImageFont.py", line 219, in __init__
    if core.HAVE_RAQM:
  File "C:\Anaconda3\lib\site-packages\PIL\ImageFont.py", line 58, in __getattr__
    raise ImportError("The _imagingft C module is not installed")
ImportError: The _imagingft C module is not installed

解决建议

重新安装带freetype支持的Pillow：
_imagingft模块依赖freetype库，默认pip安装的Pillow可能在Windows环境下缺失该依赖。Anaconda环境推荐用conda重装：
```
pip uninstall pillow -y
conda install pillow -c conda-forge
```
非conda环境可下载对应Python版本和系统架构的预编译Pillow wheel文件（包含freetype），执行本地安装：
```
pip install Pillow-9.2.0-cp37-cp37m-win_amd64.whl
```
手动指定wordcloud字体路径：
初始化WordCloud时直接指定系统中存在的字体文件，绕开默认字体加载问题，示例：
```
wordcloud = WordCloud(font_path="C:/Windows/Fonts/simhei.ttf").generate(text)
```
替换为你系统中实际存在的字体路径（如黑体、宋体等）。
降级Pillow版本：
新版本Pillow与Python3.7可能存在兼容性问题，尝试降级到稳定版本：
```
pip uninstall pillow -y
pip install pillow==8.4.0
```
补全Anaconda环境依赖：
确保环境中已安装freetype库，执行：
```
conda install freetype -c conda-forge
```
之后重新安装Pillow。

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