How to Install, Fix, and Use Python WordCloud – A Complete Guide

1. Installing WordCloud

Before using WordCloud, install the required Python packages via pip:

pip install WordCloud pip install jieba

WordCloud generates word clouds, while jieba provides Chinese word segmentation.

If you encounter the error " error: Microsoft Visual C++ 9.0 is required ", download and install VCForPython27 (Microsoft Visual C++ Compiler for Python 2.7). A direct download link is provided in the original article.

2. Simple Word Cloud Code

A basic example (adapted from the referenced blog) creates a word cloud from a list of words:

from wordcloud import WordCloud import jieba text = "你的中文文本这里" words = jieba.lcut(text) word_freq = {w: words.count(w) for w in set(words)} wc = WordCloud(font_path='msyh.ttf', width=800, height=400, background_color='white') wc.generate_from_frequencies(word_freq) wc.to_file('wordcloud.png')

The resulting image displays the most frequent keywords in a colorful cloud.

3. Chinese Encoding Error and Fix

If the generated image shows garbled characters, edit the wordcloud.py file in the library directory. Locate the FONT_PATH variable and replace the default DroidSansMono.ttf with msyh.ttf (Microsoft YaHei).

Place the msyh.ttf file in the same directory as wordcloud.py so the library can locate the Chinese font.

After fixing the font, the word cloud renders Chinese characters correctly, as shown in the example analyzing multiple CSDN blog posts.

Alternatively, you can set the font directly when creating the WordCloud object:

wordcloud = WordCloud(font_path='MSYH.TTF').fit_words(word)

4. Word Cloud with Image Background

To shape the word cloud using a background image (e.g., sss3.png), use the following core code:

from wordcloud import WordCloud, ImageColorGenerator import numpy as np from PIL import Image mask = np.array(Image.open('sss3.png')) wc = WordCloud(font_path='msyh.ttf', background_color='white', mask=mask) wc.generate_from_frequencies(word_freq) wc.recolor(color_func=ImageColorGenerator(mask)) wc.to_file('cloud_masked.png')

The resulting image blends the word cloud with the shape of the provided picture, as demonstrated by the example showing chat records.

These steps provide a complete workflow for installing, troubleshooting, and customizing WordCloud in Python, especially for Chinese text analysis.