本文介绍如何使用 formatters 参数配合自定义格式化函数，实现 DataFrame 字符串输出中各列的左对齐、固定起始位置及指定宽度排版，解决 to_string() 默认右对齐导致的错位问题。
本文介绍如何使用 `formatters` 参数配合自定义格式化函数，实现 dataframe 字符串输出中各列的左对齐、固定起始位置及指定宽度排版，解决 `to_string()` 默认右对齐导致的错位问题。
在使用 Pandas 的 to_string() 方法生成纯文本输出时，常需满足特定排版需求——例如要求第一列左对齐并起始于第 3 列（即前导 2 个空格），第二列左对齐并起始于第 10 列（即从第 10 位开始显示）。默认情况下，to_string() 会自动右对齐数值列且不提供列坐标定位能力，但可通过 formatters 参数精准干预每列的字符串渲染逻辑。
核心思路是：为每一列提供一个格式化函数，利用 Python 的 f-string 格式化语法（如 f"{x:）实现左对齐与定宽填充。注意，<code>formatters 接收一个函数列表，其长度必须与输出列数一致，按列顺序一一对应。
以下为完整可运行示例：
import pandas as pd
data = [[2025, 198237, 77, 18175],
[202, 292827, 77, 292827]]
df = pd.DataFrame(data).iloc[:, [0, 3]] # 仅保留第1列（索引0）和第4列（索引3）
# 定义左对齐格式化函数，支持动态宽度
def left_align(width):
return lambda x: f"{x:<{width}}"
# 计算各列所需最小宽度（可选：统一用最大值，或分别计算）
col0_width = len(str(df.iloc[:, 0].max())) + 3 # 第1列：最大值长度 + 3个前导空格 → 起始于第4位（索引3）
col1_width = len(str(df.iloc[:, 1].max())) + 7 # 第2列：确保起始于第10位（索引9），需预留足够空间
# 应用格式器（注意：两个列需两个独立格式器）
print(df.to_string(
index=False,
header=False,
formatters=[left_align(col0_width), left_align(col1_width)]
))输出效果（符合预期）：
2025 18175 202 292827
⚠️ 注意事项：
-
formatters不支持直接指定“绝对列位置”，而是通过设置每列总宽度（含内容+填充空格）间接控制对齐起点；若需严格对齐到第 N 列，应使前序列总宽度之和 + 当前列左填充 = N。 - 若列中含非数值类型（如字符串、NaN），建议在格式化函数中增加类型判断，避免格式化异常。
-
to_string()返回的是字符串，不可再链式调用 DataFrame 方法；如需后续处理，请先保存结果再操作。
总结：formatters 是 to_string() 中最灵活的排版工具，结合 f-string 的 （左对齐）、<code>>（右对齐）、^（居中）及动态宽度控制，可完全替代手动拼接，实现专业级表格文本输出。
