孤立森林fit时输入必须为二维数组，一维数据会报错；predict返回-1/+1需转为布尔值；contamination是训练假设上限而非精确异常率；无流式更新能力，需手动滑动窗口；单点预测无效，应结合窗口与预处理。
孤立森林 fit 时数据必须是二维数组，一维会直接报错
孤立森林（IsolationForest）底层把每个样本当作一行处理，输入 X 必须是 shape 为 (n_samples, n_features) 的二维结构。时间序列通常是单列，比如 pd.Series 或一维 numpy.ndarray，直接传进去会触发 ValueError: Expected 2D array, got 1D array instead。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 用
.values.reshape(-1, 1)强制升维，别用[:, None]——后者在空数组时可能出错 - 如果原始数据带时间索引（如
DatetimeIndex），先用.values剥离索引再 reshape，否则fit会静默失败或结果异常 - 别用
pd.DataFrame(series)自动转二维——它会把索引变成第一列，导致特征维度错乱
predict 返回 -1/+1，但实际业务需要的是布尔异常标记
IsolationForest.predict() 返回 -1 表示异常，+1 表示正常，这不是直觉上的 True/False。直接拿去画图或告警，容易逻辑翻转（比如把 -1 当成“通过”）。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 统一转成布尔：用
pred == -1，而不是pred == 1或pred.astype(bool)（后者会把 -1 当成 True） - 如果后续要拼接原时间序列，务必用
pd.Series(pred == -1, index=original_index)显式对齐索引，否则顺序错位 - 注意：
decision_function返回的是异常程度分值（越负越异常），比 predict 更适合做阈值微调，但默认不训练该函数，需显式设contamination或后续 calibrate
contamination 参数不是“异常比例”，而是训练时的假设上限
contamination 看起来像指定异常占比，但它只影响训练阶段的树切割深度和采样策略，并不保证最终 predict 出来的异常点正好占这个比例。尤其在实时流式场景下，单次滑动窗口数据少，实际异常率可能远高于或低于设定值。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 初始调试时设
contamination=0.1是合理起点，但上线前必须用历史异常样本验证召回率，不能只看 fit 输出的score_samples分布 - 如果真实异常稀疏（比如每万点只有 2–3 个），
contamination设太小（如 0.0001）会导致模型“看不见”异常，建议不低于 0.001 - 不建议依赖
contamination动态调整——它不是在线参数，每次改都要重新fit，实时监控中应固定该值，靠后处理逻辑（如连续 N 点异常才告警）补足灵敏度
实时滚动检测必须手动维护滑动窗口，isolation forest 本身不支持流式更新
IsolationForest 没有 partial_fit 方法，也不能增量更新模型。所谓“实时监控”，本质是定期用新窗口数据重训模型，或固定模型+滚动预测。前者延迟高，后者容易漂移。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 轻量级方案：每 N 个新点就取最近 M 点（如 M=1000）重新
fit一次，M 要大于n_estimators * max_samples默认值（通常 256），否则树不够深 - 稳定型方案：只训练一次（用足够长的历史周期），后续所有预测都复用该模型，但每小时用最新数据评估
score_samples的分布偏移（如均值漂移 >15% 就触发重训） - 别把单点输入
predict——孤立森林依赖样本间相对孤立程度，单点无意义；最小输入至少是 10 点以上构成的窗口
真正难的不是跑通代码，是让 IsolationForest 在时序数据上不把周期性尖峰当异常、也不漏掉缓慢漂移的底噪变化。这得靠窗口长度选得准、contamination 和实际业务异常节奏对得上，还有——别忘了加个简单的移动平均滤波预处理，很多“异常”只是高频噪声。
