【Pandas】pandas DataFrame to_excel

Pandas2.2 DataFrame

Serialization IO conversion

pandas.DataFrame.to_excel()

pandas.DataFrame.to_excel() 是 Pandas 提供的用于将 DataFrame 写入 Excel 文件的方法。它支持多种参数来控制输出格式、位置、缺失值表示等，适用于生成结构化报表或数据导出。

📌 方法签名

DataFrame.to_excel(
    excel_writer,
    *,
    sheet_name='Sheet1',
    na_rep='',
    float_format=None,
    columns=None,
    header=True,
    index=True,
    index_label=None,
    startrow=0,
    startcol=0,
    engine=None,
    merge_cells=True,
    inf_rep='inf',
    freeze_panes=None,
    storage_options=None,
    engine_kwargs=None
)

🔍 参数说明

✅ 示例及结果

示例 1：基础用法（默认参数）

import pandas as pd

# 创建一个简单的 DataFrame
df = pd.DataFrame({
    'Name': ['Alice', 'Bob', 'Charlie'],
    'Age': [25, 30, None],
    'Salary': [70000, 80000, 90000]
})

# 写入 Excel 文件
df.to_excel('example.xlsx', index=False)

输出文件内容 (example.xlsx)：

注意：Age 列中的 None 被替换为空字符串（默认行为）。

示例 2：自定义工作表名称 & 冻结窗格

# 自定义 sheet 名称并冻结第一行
df.to_excel('custom_sheet.xlsx', sheet_name='员工信息', freeze_panes=(1, 0), index=False)

输出：

• 工作表名为 员工信息
• 第一行被冻结，便于滚动查看大量数据时保持标题可见

示例 3：使用 xlsxwriter 引擎添加样式

from pandas.io.excel._xlsxwriter import XlsxWriter

# 使用 xlsxwriter 引擎并启用 bold 样式
with pd.ExcelWriter('styled.xlsx', engine='xlsxwriter') as writer:
    df.to_excel(writer, sheet_name='Data', index=False)
    
    # 获取 workbook 和 worksheet 对象
    workbook = writer.book
    worksheet = writer.sheets['Data']
    
    # 设置标题加粗
    bold_format = workbook.add_format({'bold': True})
    worksheet.set_row(0, None, bold_format)

输出：

• Data 工作表中，第一行（标题）显示为加粗字体

示例 4：从特定行列开始写入数据

# 在第3行第2列开始写入数据
df.to_excel('offset.xlsx', startrow=2, startcol=1, index=False)

输出：

• 数据从 C3 单元格开始写入，A1~B2 空白

示例 5：写入多个工作表

# 创建两个 DataFrame
df1 = pd.DataFrame({'A': [1, 2], 'B': [3, 4]})
df2 = pd.DataFrame({'X': [5, 6], 'Y': [7, 8]})

# 使用 ExcelWriter 写入多个 sheet
with pd.ExcelWriter('multi_sheets.xlsx') as writer:
    df1.to_excel(writer, sheet_name='Sheet1', index=False)
    df2.to_excel(writer, sheet_name='Sheet2', index=False)

输出：

• Sheet1 包含 A、B 列数据
• Sheet2 包含 X、Y 列数据

示例 6：自定义浮点数格式

# 设置浮点数保留两位小数
df.to_excel('formatted.xlsx', float_format="%.2f", index=False)

输出：

• 所有浮点数列（如 Age）显示为两位小数：

⚠️ 注意事项

• 推荐使用 xlsxwriter 或 openpyxl 引擎，支持 .xlsx 格式。
• 若需读取 Excel 文件，可使用 pd.read_excel()。
• 多个 sheet 写入时，必须使用 ExcelWriter 上下文管理器。
• 冻结窗格功能在 xlsxwriter 中支持良好。
• 不建议使用 xlwt 引擎（仅支持 .xls，不支持新特性）。

🧰 安装依赖

pip install pandas openpyxl xlsxwriter

📝 总结