本文详解如何在 Pandas 中对 merge 后的 DataFrame 进行列顺序重排——关键在于使用列名列表索引而非 sort_values()，后者仅排序行数据，无法调整列结构。
本文详解如何在 pandas 中对 merge 后的 dataframe 进行列顺序重排——关键在于使用列名列表索引而非 `sort_values()`，后者仅排序行数据，无法调整列结构。
在使用 pd.merge() 合并两个 DataFrame 后，列顺序默认由左表（df）列优先、右表（df2）新增列追加的方式生成，往往不符合最终导出（如 Excel）所需的逻辑布局。许多用户误将 sort_values() 用于列重排，例如：
# ❌ 错误示例：这是按行值排序，不是重排列！ df3 = df3.sort_values(by=["home", "away", "htresult", ...])
该操作仅对行记录按指定列的值升序排列，完全不会改变列的物理顺序，因此导出 Excel 时仍显示杂乱的列结构。
✅ 正确做法是：通过方括号索引（df3[...]）显式指定目标列名列表，Pandas 将严格按该顺序返回新 DataFrame：
# ✅ 正确：按需定义列顺序（支持原列、新增列、跨表列混合）
df3 = df3[
["home", "away", "scorehome", "scoreaway",
"htresult", "shresult", "result",
"best_bets", "oddtwo", "oddthree",
"sum_stats", "over05", "over15", "over25", "over35", "over45",
"goal", "esito", "tournament", "uniquefield"]
]
⚠️ 注意事项：
- 列名必须完全匹配（区分大小写与空格），缺失或拼错将引发 KeyError；
- 若合并后右表字段（如 home2, htresult）未被 drop() 删除，则必须包含在该列表中，否则会被自动丢弃；
- 推荐在 merge 后立即重排列顺序，再执行 sort_values()（如需行排序）或导出，避免逻辑混淆；
- 可提前将目标列顺序存为变量，提升可读性与复用性：
desired_cols = [
"home", "away", "scorehome", "scoreaway",
"htresult", "shresult", "result",
"best_bets", "oddtwo", "oddthree",
"sum_stats", "over05", "over15", "over25", "over35", "over45",
"goal", "esito", "tournament", "uniquefield"
]
df3 = df3[desired_cols] # 清晰、安全、易维护
最后，导出至 Excel 即可获得符合预期的列布局：
df3.to_excel("BexDataFull.xlsx", index=False)
print("✅ Excel 文件已成功生成，列顺序已按指定要求排列。")
掌握这一简单而关键的操作，能显著提升数据处理流程的可控性与交付质量。
