升级 pandas 前,先跑一遍数据结果兼容检查
数据工具升级最麻烦的地方,不一定是 API 报错,而是默认行为改变后结果还能跑出来,却和原来不一样。版本变更前,先把关键数据结果固定下来。
建立小而有代表性的样本
样本覆盖空值、重复键、时区、分类字段和边界日期。保存输入文件校验值、当前依赖锁文件及期望输出。对浮点结果写明允许误差,不要简单比较格式化后的字符串。
分开验证读取、变换和输出
读取重点看类型推断和日期解析,变换关注 groupby、merge 与排序,输出检查列顺序、编码和索引。这样出现差异时能定位到具体阶段,而不是在整个 notebook 里逐格猜。
回退不只换回包版本
若新版本已经生成缓存或中间文件,旧版本是否还能读取也要确认。灰度任务使用独立输出位置,关闭开关后不覆盖原路径。依赖包同步升级时,每次尽量只变一个关键条件。
升级结论应附样本和命令。写“兼容”很轻松,能让别人复现同一结果才算真正检查过。