本文面向python零基础学员，详细讲解如何使用python-docx库,遍历DataFrame数据并生成格式化的Word文档,为《财务大数据分析（基于python）》p283输出word部分的学习辅导读物。适用场景如将采集到投资者互动关系问答输出到WORD文档。
学习目标：
理解DataFrame的遍历方法
掌握python-docx库的基本操作
学会设置字体样式（大小、颜色）
理解循环结构在数据处理中的应用
第一部分：环境准备与库导入
【知识点1】库的安装与导入
python-docx 是一个用于创建和修改Word文档(.docx)的Python库。
安装命令（在命令行/终端中执行）：pip install python-docx
或者使用国内镜像源加速安装：
pip install python-docx -i https://pypi.tuna.tsinghua.edu.cn/simple
安装完毕之后，再导入库，所以，多数的python代码第一部分均是导入库，相当于导入我们将使用的工具。如下：
from docx import Document # 导入Document类，用于创建Word文档from docx.shared import Pt, RGBColor # 导入字体大小和颜色设置工具import pandas as pd # 导入pandas，用于数据处理
第二部分：理解核心数据结构——DataFrame
【知识点2】什么是DataFrame？
DataFrame是pandas库中最核心的数据结构，可以理解为一个二维表格，类似于Excel中的工作表或数据库中的数据表。DataFrame的结构如下：
行（index）：每一条记录的编号
列（columns）：每个字段的名称
值（values）：具体的数据内容
实际项目中，DataFrame数据通常来自数据库查询结果、API接口返回的JSON数据、Excel/CSV文件读取。我们也可以使用pd.DataFrame()将字典转换为DataFrame。如：
stock_irm_cninfo_df = pd.DataFrame(data)
第三部分：创建Word文档基础
【知识点3】Document对象——Word文档的载体
Document类是python-docx库的核心，代表一个Word文档。创建Document对象即创建一个新的空白Word文档。常用方法如下：
doc.add_paragraph() #添加一个新段落doc.add_heading() #添加标题doc.add_table() #添加表格doc.save() #保存文档到文件
以下代码可以牢记，至少应该是能看懂。
# 创建一个新的Word文档对象doc = Document()# 添加文档标题title = doc.add_heading('投资者关系问答记录', level=0)# 添加说明段落intro = doc.add_paragraph()intro.add_run('本文档由Python自动生成，记录了公司与投资者的互动问答内容。')# 添加空行分隔doc.add_paragraph()
第四部分：核心代码详解——遍历DataFrame并写入文档
【知识点4】DataFrame的遍历方法——iterrows()
iterrows()是DataFrame的行迭代器，每次循环返回两个值：
index: 当前行的索引号（从0开始）
row: 当前行的数据（Series类型，可通过列名访问值）
语法格式：
for index, row in dataframe.iterrows():# index: 行号# row['列名']， 获取该列的值
【知识点5】python-docx的段落和文本样式设置
1. 添加段落：
p = doc.add_paragraph() # 创建空段落
2. 添加文本（Run对象）：
run = p.add_run('文本内容') # 在段落中添加文本
3. 设置字体大小：
run.font.size = Pt(12) # 设置字号为12磅（小四号）
常用字号对照：
- Pt(10.5) = 五号字
- Pt(12) = 小四号字
- Pt(14) = 四号字
- Pt(16) = 小三号字
- Pt(18) = 三号字
4. 设置字体颜色：
run.font.color.rgb = RGBColor(红, 绿, 蓝)
RGB颜色模型：
- RGBColor(0, 0, 0) = 黑色
- RGBColor(255, 0, 0) = 红色
- RGBColor(0, 0, 255) = 蓝色
- RGBColor(128, 128, 128) = 灰色
每个颜色通道取值范围：0-255
# 遍历问题和回答并添加到文档中for index, row in stock_irm_cninfo_df.iterrows():# ------------------- 打印当前处理进度（便于理解） -------------------print(f"\n正在处理第 {index + 1} 条记录...")print(f" 提问时间: {row['提问时间']}")
【代码详解】
p = doc.add_paragraph()
解释：调用Document对象的add_paragraph()方法，创建一个新的空白段落。 返回的p是一个Paragraph对象，代表这个段落。
run = p.add_run(f"时间: {row['提问时间']}")
解释：在段落p中添加文本。f"时间: {row['提问时间']}" 是Python的f-string格式化字符串；row['提问时间'] 从当前行数据中获取"提问时间"列的值，最终文本如："时间: 2024-01-15"；run是一个Run对象，代表一段具有相同样式的文本。
run.font.size = Pt(12)
解释：设置run对象（即这段文本）的字体大小为12磅。Pt是python-docx中用于表示磅值的单位类。
run.font.color.rgb = RGBColor(0, 0, 0)
解释：设置文本颜色为纯黑色。RGBColor(0, 0, 0)表示红色=0、绿色=0、蓝色=0，即黑色。
p = doc.add_paragraph()run = p.add_run(f"时间: {row['提问时间']}")run.font.size = Pt(12) # 设置字体大小为12磅run.font.color.rgb = RGBColor(0, 0, 0) # 设置字体颜色为黑色run.font.bold = True # 加粗显示（新增：增强可读性）
【拓展】使用不同颜色区分不同类型的内容
在实际应用中，我们常常用颜色来区分信息类型：
黑色：基本信息（时间、编号等）
蓝色：问题/提问内容
绿色：回答/回复内容
红色：重要提示或警告
p = doc.add_paragraph()run = p.add_run(f"提问: {row['提问内容']}")run.font.size = Pt(12)run.font.color.rgb = RGBColor(0, 0, 255) # 蓝色，表示提问
================== 添加回答内容（深绿色） ==================
p = doc.add_paragraph()run = p.add_run(f"回答: {row['回答内容']}")run.font.size = Pt(12)run.font.color.rgb = RGBColor(0, 128, 0) # 深绿色，表示回答
================== 添加回答时间（灰色） ==================
p = doc.add_paragraph()run = p.add_run(f"回复时间: {row['回答时间']}")run.font.size = Pt(10.5) # 稍小字号run.font.color.rgb = RGBColor(128, 128, 128) # 灰色，表示辅助信息run.font.italic = True # 斜体（新增）
================== 步骤5：添加分隔线 ==================
# 添加空行作为分隔doc.add_paragraph()# 添加一条水平分隔线（使用下划线段落）separator = doc.add_paragraph()separator_run = separator.add_run("─" * 50)separator_run.font.color.rgb = RGBColor(200, 200, 200)separator_run.font.size = Pt(8)# 再添加一个空行doc.add_paragraph()
第五部分：保存文档
【知识点6】保存文档
doc.save('文件名.docx')
将内存中的Document对象保存为.docx文件
如果文件已存在，会被覆盖
保存路径可以是相对路径或绝对路径
# 保存文档output_filename = '投资者关系问答记录.docx'doc.save(output_filename)print(f"\n文档已保存为: {output_filename}")print("\n提示：请使用Microsoft Word或WPS打开查看效果。")
【进阶技巧】
1. 设置中文字体：
run.font.name = '微软雅黑'
2. 设置段落间距：
p.paragraph_format.space_before = Pt(6) # 段前间距
p.paragraph_format.space_after = Pt(6) # 段后间距
3. 设置行距：
p.paragraph_format.line_spacing = 1.5 # 1.5倍行距
4. 添加表格：
table = doc.add_table(rows=3, cols=2)
table.cell(0, 0).text = '项目'
table.cell(0, 1).text = '内容'
5. 添加页眉页脚：
header = doc.sections[0].header
header.paragraphs[0].text = '机密文件'
【要点回顾】
print("\n【学习要点回顾】")print("1. DataFrame.iterrows() 用于逐行遍历表格数据")print("2. doc.add_paragraph() 创建新段落")print("3. p.add_run() 在段落中添加文本并设置样式")print("4. Pt() 设置字体大小（磅值）")print("5. RGBColor() 设置字体颜色（红绿蓝三通道）")print("6. doc.save() 保存文档到文件")
