Yellowbrick 是专为模型诊断设计的 scikit-learn 兼容可视化层，需严格按 fit()→score()→show() 流程调用；其图表依赖正确标签编码、数据预处理与统计假设，非装饰性绘图工具。
Yellowbrick 不是替代 matplotlib 或 seaborn 的绘图库，而是专为 模型诊断 设计的 scikit-learn 兼容可视化层。它不画“好看图表”，而是画“能回答建模问题”的图——比如“这个模型是不是在训练集上死记硬背？”“哪几个特征拖了后腿？”“两个分类器到底差在哪？”。直接上手前，先确认你真正需要的是诊断，而不是装饰。
为什么 fit() 后必须调用 score() 和 show()？
很多初学者卡在图不显示或指标为空，根本原因是误把 Visualizer 当成普通绘图函数。它本质是 scikit-learn 风格的 estimator：必须先 fit()（传入训练数据），再 score()（传入测试数据计算指标），最后 show()（渲染）。漏掉 score()，ROC 曲线没 AUC 值，残差图没 R²，肘部图没失真分数。
-
fit(X_train, y_train)：让 visualizer 学习训练数据分布或模型行为 -
score(X_test, y_test)：触发内部评估逻辑，填充坐标轴、标注、统计值 -
show()：才是最终绘图动作；不调用它，poof()（旧版）或show()（v1.5+）都不会出图
混淆矩阵热力图里对角线颜色不对？检查 y_true 的编码方式
ConfusionMatrix 对输入标签极其敏感：它不会自动做 LabelEncoder 转换。如果你的 y_true 是字符串（如 ["cat", "dog", "bird"]），而模型输出是整数预测（如 [0, 1, 2]），热力图会错位甚至报错 ValueError: Found array with dim 3. Expected 。
- 统一用整数编码：用
sklearn.preprocessing.LabelEncoder预处理y_train和y_test - 或改用
ClassificationReport，它内部做了类型对齐，容错更强 - 验证方法：打印
set(y_train)和set(y_test)，确保二者类别集合完全一致
KMeans 肘部图结果不明显？别只看“拐点”，盯紧参数和指标定义
KElbowVisualizer 默认用 distortion（簇内平方和），但对非球形簇或高维稀疏数据常失效。你看到的“平缓下降”可能不是模型问题，而是指标选错了。
立即学习“Python免费学习笔记（深入）”；
- 强制换指标：传参
metric="silhouette"或"calinski_harabasz"，三者物理意义不同，常给出不同“最佳 k” - 限制 k 范围：默认从 2 到 min(10, n_samples//2)，若你业务明确只需 k=3~6，加
k=(3, 6)避免无效搜索 - 注意随机性：KMeans 本身有初始化波动，加
random_state=42保证可复现，否则每次运行肘部位置都飘
ParallelCoordinates 图一堆线缠成毛线团？预处理比调参更重要
平行坐标图天生容易过载，尤其当特征量 > 8 或样本数 > 500。这不是 Yellowbrick 的 bug，而是高维可视化的固有瓶颈。
- 先降维：对原始
X做StandardScaler，否则量纲差异会让温度（℃）和 ID（整数）压成一条线 - 再筛选：用
Rank2D(algorithm="pearson")扫一遍相关性，剔除冗余特征（如temp和feelslike相关系数 > 0.95） - 最后抽样：传入
X_sample = X.sample(n=200, random_state=42)，人眼分辨不了上千条线，200 条已足够识别模式
Yellowbrick 的复杂点不在语法，而在每张图背后隐含的统计假设和适用边界。比如 ResidualsPlot 要求残差近似正态，ROCAUC 只适用于二分类且预测概率可用——这些不会报错，但会静默给出误导性图形。动手前，花 30 秒扫一眼文档里那句 “This visualizer assumes…”。
