必须用 suffixes 参数显式控制重名列命名，不能依赖默认的\_x/\_y；只要两个DataFrame有同名列且该列不是合并键就会冲突，Pandas强制要求指定左右后缀，常见误判是以为仅数值列冲突，实则status、updated_at等业务字段更易撞车。
必须用 suffixes 参数显式控制重名列命名，不能依赖默认的 _x/_y —— 否则后续分析极易出错，且错误常在下游才暴露。
merge 时列名冲突到底怎么触发的
只要两个 DataFrame 有同名列（哪怕只是 id、name、region 这种常见字段），且该列不是合并键（on 指定的列），就会冲突。Pandas 不会自动丢弃或覆盖，而是强制要求你说明“左边的叫什么、右边的叫什么”。
- 常见误判：以为只有
value这种数值列才冲突，其实status、updated_at、source等业务字段更常撞车 - 类型不一致也会加剧问题：比如左表
id是int64，右表是object（含空字符串），merge 会静默转成object，但列名仍冲突 - 没写
on或写错列名时，Pandas 可能尝试用所有同名列当键，导致意外的MergeError: columns overlap but no suffix specified
suffixes 参数怎么设才不踩坑
suffixes 必须是长度为 2 的元组，顺序固定：(left_suffix, right_suffix)。它只作用于非键列，不影响 on 列。
Secure Python Code Sandbox
下载
安全 Python 代码沙箱：在隔离的沙箱中执行任意 Python 代码，预装 requests、NumPy、pandas 库。返回 stdout、stderr。
- 别用
('_1', '_2')或('_a', '_b')——语义模糊，一个月后自己都看不懂哪边是主数据 - 生产环境优先用业务含义后缀，比如
('_user', '_order')、('_base', '_delta')、('_src', '_ref') - 临时调试可接受
('_l', '_r')，但上线前必须改掉 - 如果某张表的列名本身已带下划线（如
user_id_old），后缀再加_old会导致冗长，建议提前用df.rename(columns={...})统一清理
多表 merge 时 suffixes 容易被忽略的关键点
用 functools.reduce 合并多个表时，suffixes 不能只设一次 —— 每次两两 merge 都要传，否则中间某步冲突就崩。
立即学习“Python免费学习笔记（深入）”；
- 错误写法：
reduce(lambda l,r: pd.merge(l,r,on="id"), dfs)—— 完全没传suffixes，第二张表一进来就报错 - 正确写法：把
suffixes写进封装函数里，例如def merge_with_suffix(left, right): return pd.merge(left, right, on="id", suffixes=("_main", "_ext")) - 如果不同表对需要不同后缀（比如前三张用
_v1，最后一张用_log），就得拆开 merge，不能硬塞进一个reduce -
concat不走suffixes逻辑，它用的是keys或names参数来分层，拼接前务必先检查列名是否已去重
最麻烦的情况不是列名重复，而是重复列名背后语义不同却类型相同（比如两个 score，一个是考试分，一个是系统评分）。这时候光靠 suffixes 不够，得配合业务注释或提前重命名，否则合并完的数据谁也说不清哪列该信。
