SMOTE导致precision崩盘的根本原因是未标准化时欧氏距离受量纲影响，使插值样本业务失真；必须先标准化再SMOTE，且需用imblearn.pipeline.Pipeline配合交叉验证防数据泄露。
SMOTE.fit_resample() 为什么让模型 precision 崩盘
直接对原始训练集调用 SMOTE.fit_resample(X_train, y_train) 后训练模型，常出现 recall 小幅上升、precision 断崖下跌、F1 不升反降——根本原因不是 SMOTE 本身失效，而是它在“看不见量纲”的前提下强行算欧氏距离。
比如特征含 income（万元级）和 age（个位数），未标准化时，邻居搜索几乎只由 income 主导，插值生成的样本在业务上不合理（如“35岁、年收入98.7万元”的合成用户，实际可能根本不存在于该客群分布中）。
- 必须先用
StandardScaler或MinMaxScaler对X_train拟合并转换，再喂给 SMOTE - 绝不能对整个数据集（含后续验证/测试部分）做 scaler + SMOTE，否则造成 data leakage
- 正确顺序：train_test_split → scaler.fit_transform(train_X) → SMOTE.fit_resample(train_X_scaled, train_y)
Pipeline 里放 SMOTE 为何还是泄露了
写成 sklearn.pipeline.Pipeline([('scaler', StandardScaler()), ('smote', SMOTE()), ('clf', LogisticRegression())]) 看似规范，实则失效。问题出在 fit() 阶段：Pipeline 会把整块训练数据传给 smote.fit_resample()，而后续 cross_val_score 的每一折验证数据，其分布已被该次全局 SMOTE “污染”过。
imblearn 自带的 Pipeline 才能保证每折 CV 内部独立重采样：
立即学习“Python免费学习笔记（深入）”；
- 必须导入
from imblearn.pipeline import Pipeline，而非sklearn.pipeline -
SMOTE必须放在 Pipeline 中作为 transformer（即支持fit_resample的步骤），且仅作用于当前 fold 的训练子集 - 示例：
pipe = Pipeline([('scaler', StandardScaler()), ('smote', SMOTE(random_state=42)), ('clf', LogisticRegression())])，再传给cross_val_score(pipe, X_train, y_train, cv=5)
k_neighbors=5 是默认值，但大概率不是最优值
SMOTE 默认 k_neighbors=5，但在小样本或高维场景下极易生成离群点。例如少数类仅 25 个样本，强制找 5 个最近邻，其中可能混入噪声或误标样本，插值结果反而落入多数类区域。
- 从
k_neighbors=3起步；若少数类样本数 SVMSMOTE 或放弃 SMOTE - 高维特征（>20 列）建议先用
PCA或SelectKBest降维，再 SMOTE - 可组合使用：如先
SMOTE(k_neighbors=3)，再接RandomUnderSampler剔除边界模糊样本（即SMOTEENN）
fit_sample() 已弃用，别再用
旧文档里常见 smote.fit_sample(X, y)，这在 imblearn ≥ 0.9 版本中已被标记为 deprecated，并将在后续版本移除。调用它会触发 FutureWarning，且部分新参数（如 sampling_strategy）不生效。
- 统一改用
smote.fit_resample(X, y) -
sampling_strategy控制目标比例，如sampling_strategy={0: 500, 1: 500}或'auto'（平衡至多数类数量） - 安装确认：
pip install --upgrade imbalanced-learn，避免因版本陈旧导致 API 行为不一致
