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