必须用jieba分词并过滤单字后输入wordcloud，指定中文字体路径，合理设置max_words与max_font_size，必要时加载自定义词典。
wordcloud 生成空白图？检查输入文本是否被切成了单字
中文不加预处理直接喂给 WordCloud，大概率得到满屏“的”“了”“在”“我”，甚至全是单个汉字——因为默认分词方式对中文无效。它把字符串当英文一样按空格/标点切，而中文没空格，结果每个字符都被当成一个“词”。
必须先用 jieba 分好词，再拼成带空格的字符串：
import jieba text = "Python数据分析很实用，但词云图容易做错" words = jieba.lcut(text) # ['Python', '数据', '分析', '很', '实用', '，', '但', '词云图', '容易', '做错'] clean_words = [w for w in words if len(w.strip()) > 1] # 过滤单字、标点 processed = " ".join(clean_words) # "Python 数据分析 实用 词云图 容易 做错"
- 别用
jieba.cut（返回生成器），要用jieba.lcut或list(jieba.cut(...)) -
stopwords参数只过滤完整词，不会合并“数据”和“分析”，所以预处理阶段就得拆准 - 如果原始文本含大量数字、英文混合，
jieba.lcut_for_search比lcut更细粒度
中文显示为方块？font_path 必须指定支持中文的字体文件
WordCloud 默认字体不支持中文，font_path=None 时会 fallback 到无中文的字体，所有汉字变 □。这不是编码问题，是字体缺失。
Windows 下可用 "simhei.ttf"（黑体），macOS 推荐 "/System/Library/Fonts/PingFang.ttc"，Linux 常用 "/usr/share/fonts/truetype/wqy/wqy-microhei.ttc"：
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
wc = WordCloud(
font_path="/System/Library/Fonts/PingFang.ttc", # macOS 示例
width=800,
height=400,
background_color="white"
)
- 路径必须存在且可读，用
os.path.exists()检查下 - 不要用系统字体别名（如 "Heiti SC"），
WordCloud不识别，只认真实文件路径 - 如果打包成 exe，字体文件要一并拷贝，并用
sys._MEIPASS动态拼路径
词频不准、高频词没放大？max_words 和 max_font_size 配置冲突
max_words=100 是指最终保留的 top-100 词，不是输入词数；max_font_size 控制最大字号，但若设太小（如 20），即使词频最高，视觉上也显不出来。
- 先确认
generate_from_frequencies()输入的 dict 是否真有频次差异，打印前几项看看 -
relative_scaling=0.5比默认0.5更敏感（值越大，高频词字号越突出） - 避免同时设
max_words=10又min_font_size=40：词太少 + 字太大 = 溢出画布，部分词被裁掉 - 调试时临时加
collocations=False，禁用二元词组，排除组合逻辑干扰
jieba 分词不准怎么办？自定义词典比调参数更直接
比如文本里反复出现“大模型”“AIGC”，但 jieba 默认切成“大 / 模型”“AI / GC”，导致词频分散。硬调 cut_all=True 或 HMM=False 效果不稳定。
直接加载自定义词典最可靠：
jieba.load_userdict("mydict.txt") # 每行一个词，可带权重（可选）
# mydict.txt 内容示例：
# 大模型 100 nz
# AIGC 100 eng
- 词典文件用 UTF-8 编码，无 BOM
- 权重影响切分优先级，但不改变频次统计，最终词频还是看原文出现次数
- 如果用
jieba.add_word("大模型")，记得在lcut前调用，且每次运行只加一次，重复加会报错
事情说清了就结束。最常卡住的其实是第一步：以为 wordcloud 能自动处理中文，结果喂进去的是“乱码式分词”。真正要动的不是 wordcloud 的参数，而是它前面那一步——分词是否真的产出你想要的词。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
