• Python环境： Python 3.6或更高版本（推荐Python 3.8+）
• 包管理工具： pip已安装并更新到最新版本
• 依赖库： 安装必要的依赖库（安装时会自动处理）

检查Python和pip版本：

# 检查Python版本
python --version

# 检查pip版本
pip --version

# 更新pip
pip install --upgrade pip

标准安装步骤：

# 打开命令提示符(CMD)或PowerShell
pip install wordcloud

安装依赖库：

# 安装numpy和matplotlib
pip install numpy matplotlib

# 安装Pillow用于图像处理
pip install pillow

使用pip安装：

# 打开终端
pip3 install wordcloud

使用Homebrew安装依赖：

# 安装Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装Python开发依赖
brew install freetype

Ubuntu/Debian：

# 安装系统依赖
sudo apt-get install python3-dev build-essential

# 安装wordcloud
pip install wordcloud

CentOS/RHEL：

# 安装开发工具
sudo yum groupinstall "Development Tools"
sudo yum install python3-devel

# 安装wordcloud
pip install wordcloud

1. Microsoft Visual C++ 14.0 required

解决方案： 安装Visual Studio构建工具或使用预编译的wheel文件

# 访问：https://visualstudio.microsoft.com/visual-cpp-build-tools/
# 下载并安装"Visual Studio Build Tools"

# 或者使用预编译版本
pip install wordcloud‑1.8.1‑cp39‑cp39‑win_amd64.whl

2. 安装过程中出现freetype错误

解决方案： 安装freetype开发库

# Ubuntu/Debian
sudo apt-get install libfreetype6-dev

# MacOS
brew install freetype

3. 中文显示为方框

解决方案： 指定中文字体路径

font_path = "C:/Windows/Fonts/simhei.ttf"  # Windows
# 或
font_path = "/System/Library/Fonts/PingFang.ttc"  # MacOS

from wordcloud import WordCloud
import matplotlib.pyplot as plt

# 示例文本
text = ("Python Python Python 数据 可视化 wordcloud 库 安装 教程 "
        "词云 生成 示例 代码 中文 支持 数据分析")

# 创建词云对象（中文需指定字体路径）
wordcloud = WordCloud(
    font_path="simhei.ttf",  # 替换为你的中文字体路径
    width=800,
    height=600,
    background_color="white"
).generate(text)

# 显示词云
plt.figure(figsize=(10, 8))
plt.imshow(wordcloud, interpolation="bilinear")
plt.axis("off")
plt.show()

高级用法：使用形状蒙版

from wordcloud import WordCloud, STOPWORDS, ImageColorGenerator
from PIL import Image
import numpy as np

# 加载蒙版图像
mask = np.array(Image.open("cloud_shape.png"))

# 创建词云对象
wc = WordCloud(
    background_color="white",
    mask=mask,
    max_words=200,
    contour_width=3,
    contour_color="steelblue"
)

# 生成词云
wc.generate(text)

# 显示词云
plt.imshow(wc, interpolation="bilinear")
plt.axis("off")
plt.show()