Pandas 2.0 硬性删除了 as_matrix()、sort_values(inplace=True) 等 API，且无 fallback；pd.unique() 对 list 输入返回 numpy array，read_csv 默认 encoding 改为 "utf-8"；需用警告转错误、pylint 和运行时检查定位兼容问题。
直接换 pandas>=2.0 会炸，尤其当你依赖 read_csv 的默认行为、sort_values 的 inplace 参数，或用 pd.DataFrame.as_matrix() 这类已被彻底移除的方法时——这些不是警告，是运行时报错。
哪些API在2.x中被硬性删除？
不是所有弃用都留后路。Pandas 2.0 移除了大量旧接口，且不提供 fallback 路径：
-
as_matrix()：已完全消失，必须改用.values或.to_numpy() -
sort_values(inplace=True)：inplace参数被删，所有 inplace 操作需显式赋值：df = df.sort_values("col") -
pd.unique()对 list 输入的行为变更：1.x 返回 list，2.x 返回 numpy array，若后续接.append()会直接报错 -
pd.read_csv(..., encoding=None)：2.x 默认值从None改为"utf-8"，读取 GBK 文件时不再自动探测，必须显式传encoding="gbk"
如何检测代码里藏着多少“1.x遗民”？
别靠肉眼扫，用工具定位真实断裂点：
- 加启动参数跑测试：
python -W error::FutureWarning -W error::DeprecationWarning your_script.py，让所有 warning 变 error，提前暴露问题 - 用
pylint配置--extension-pkg-whitelist=numpy,pandas+--disable=missing-module-docstring，启用deprecated-argument和no-member规则 - 对关键 DataFrame 操作加运行时检查：比如在调用
sort_values前插入assert not hasattr(df.sort_values, "inplace")（仅调试期）
兼容层怎么写才不踩坑？
简单封装不如精准拦截。以下模式比全局替换更稳：
立即学习“Python免费学习笔记（深入）”；
- 对
as_matrix：不要写def as_matrix(self): return self.values，而应直接搜代码替换，因为.values在 2.x 中返回 view，.to_numpy()才保证 copy 行为一致 - 对
read_csv编码逻辑：封装函数时别只判断 Python 版本，要检查文件头 BOM 或用chardet探测，否则encoding="utf-8"强制指定会把乱码当正常数据读入 - 避免在兼容层里做类型转换：比如把
pd.unique([1,2,2])结果统一转 list，这掩盖了底层 array vs list 的语义差异，后续用index()或count()仍可能出错
最麻烦的不是语法改写，而是那些没报错但结果变了的地方——比如 groupby().size() 在 2.x 中默认返回 Series 而非 DataFrame，下游用 .iloc[0,0] 就崩。这种隐性断裂，得靠数据快照比对才能揪出来。
