You need to enable JavaScript to run this app. Python docx模块中如何将pandas Style对象的格式化值写入Word表格
优惠活动
大模型
产品
解决方案
定价
更多

Python docx模块中如何将pandas Style对象的格式化值写入Word表格

问题本质
  • 调用pandas的.style.format()方法后返回的Styler对象是专门用于前端渲染、静态文件样式导出的封装层,不会修改原始DataFrame的数值存储,仅绑定展示规则用于生成带格式的网页视图、Excel文件。
  • 直接将Styler对象覆盖原DataFrame变量后,无法通过常规的df.columns、df.values接口取到对应的数据和格式化后的文本,会导致Word表格写入时出现类型错误、值为原始未格式化数值的问题。
可复现的正确实现方式

核心思路是原始数据存储与格式化逻辑解耦,不要用Styler对象覆盖原始DataFrame,复用预先定义的格式规则,在写入Word表格时逐值完成格式化:

  • 保留未做样式处理的原始DataFrame作为数据源
  • 提前定义各列对应的格式化规则,可同时供Word写入、Excel样式导出两个场景复用
  • 遍历表格写入单元格时,对每个原始值套用对应列的格式化规则,生成符合要求的字符串再写入

修正后的可运行代码

import pandas as pd
import docx

# 初始化原始数据
data = [[150000, 100000, 0.14565], [250000, 200000, 0.16334]]
df = pd.DataFrame(data, columns=['Revenues', 'Expenditures', 'Surplus'])

# 统一定义列格式化规则,避免重复配置
format_rules = {
    "Revenues": "${:20,.0f}",
    "Expenditures": "${:20,.0f}",
    "Surplus": "{:.2%}"
}

# 初始化Word文档与表格
doc = docx.Document()
# 表格总行数 = 1行表头 + 全部数据行
table = doc.add_table(rows=df.shape[0] + 1, cols=df.shape[1])

# 写入表头内容
for col_index, col_name in enumerate(df.columns):
    table.cell(0, col_index).text = col_name

# 逐行写入格式化后的数据
for row_index in range(df.shape[0]):
    for col_index, col_name in enumerate(df.columns):
        raw_value = df.iloc[row_index, col_index]
        # 按照列规则生成格式化文本,去除原格式定义中的多余填充空格
        formatted_text = format_rules[col_name].format(raw_value).strip()
        table.cell(row_index + 1, col_index).text = formatted_text

doc.save('hello_python_output.docx')
扩展场景适配

如果后续需要同时导出带样式的Excel文件,不需要修改Word场景的逻辑,直接基于原始DataFrame生成Styler对象即可:

# 生成带样式的Excel导出对象,与Word写入逻辑完全解耦
excel_styler = df.style.format(format_rules)
excel_styler.to_excel("styled_output.xlsx", index=False)

内容的提问来源于stack exchange,提问作者beverlydrive

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.01 04:24:02