### pandas `to_excel` 方法参数详解 #### 基本功能描述 `pandas.DataFrame.to_excel()` 函数用于将 DataFrame 对象写入 Excel 文件。此函数提供了多种选项来控制输出格式和结构。 #### 主要参数说明 - **excel_writer**: str 或 ExcelWriter 对象 输出的目标路径或已创建的 ExcelWriter 实例。如果提供字符串，则会自动创建一个新的 ExcelWriter[^2]。 - **sheet_name**: str, default ‘Sheet1’ 表格名称，默认为 "Sheet1"。可以自定义工作表的名字以便更好地识别不同数据集的内容。 - **na_rep**: str, default '' (空字符) 缺失值表示形式，当单元格为空时使用的替代符号。 - **float_format**: callable, optional 浮点数格式化器，允许用户指定浮点数值显示的方式。 - **columns**: list-like, optional 需要写出到 Excel 的列名列表；默认全部导出。这使得可以选择特定的数据字段进行保存。 - **header**: bool or list of str, default True 是否包含列头信息。设置为 False 可以不记录列标题；也可以传递一个由新标题组成的序列作为替换原表格头部的信息。 - **index**: bool, default True 控制是否将索引也一起存储至 Excel 中。对于某些应用场景来说可能不需要保留原始索引位置。 - **startrow**, **startcol**: int, default 0 定义数据起始行号/列号（从零开始计），可用于在同一张工作簿内安排多个数据区域的位置关系。 - **engine**: string, default None 使用哪个库来进行操作 ('xlrd', 'openpyxl') 。通常情况下 Pandas 自动选择合适的引擎。 - **merge_cells**: boolean, default True 如果有重复标签则合并这些单元格。注意该行为可能会被禁用以防止潜在错误发生。 - **encoding**: string, optional 文字编码方式，在较旧版本中可能是必要的配置项之一，但在现代环境中较少提及。 - **verbose**: boolean, default True 打印额外的日志消息帮助调试问题所在之处。 - **freeze_panes**: tuple, optional 设置冻结窗格的功能，接受两个整型元组(x,y)，分别代表水平方向上第一个固定列以及垂直方向上的首行编号。 ```python import pandas as pd # 创建示例DataFrame data = {'Name': ['Alice', 'Bob'], 'Age': [25, 30]} df = pd.DataFrame(data) # 导出到Excel并应用部分参数 df.to_excel('example.xlsx', sheet_name='PeopleInfo', na_rep='N/A', float_format="%.2f", columns=['Name'], header=True, index=False, startrow=1, startcol=1) ```