刘姐是个行政主管，每周要给全公司做周报PPT。内容倒是不难，数据都是现成的，翻来覆去就那几项核心指标。最要命的是排版——每页都要重新拖文本框、调字号、改字体、设置行距，一干就是大半个下午。她总跟我抱怨，说最可恨的是下周还得重来一遍。
我告诉她，这些重复劳动完全可以用代码一次性写定。Python里有意思的库叫python-pptx，专门用来操作PPT。
她将信将疑地看着我："我连PPT都不熟，还让我写代码？"
如果用代码来做，核心就是三件要紧事：在哪里放字、写什么内容、文字长什么样。今天这篇文章，咱们就认认真真说清楚这三件事如何用几行Python解决。
刘姐的日常，其实就是典型的Office办公自动化痛点，而这些痛点往往只需要一些经验性的小技巧就能一次性解放。下面我来分享真实的操作细节。
搭建干净的"画布"：新建目录页
要用代码在PPT里写字，得先有个能写字的页面。我们直接打开一个新的PPT，在里面添一页，再在上面放一个文本框：
from pptx import Presentation
from pptx.util import Inches
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])
textbox = slide.shapes.add_textbox(Inches(1), Inches(1), Inches(5), Inches(2))
textbox.text_frame.text = "我是自动生成的"
prs.save("我的第一个文本框.pptx")
刚开始你可能心里犯嘀咕，这些看似复杂的数值究竟是干嘛用的。add_textbox方法里有4个必填参数，分别控制文本框离左边的距离、离上边的距离、宽度和高度，修改它们可以精确控制文本位置。
运行上面那段代码，生成的PPT里会多出一页空白页面，上面静静地躺着一个文本框，写着“我是自动生成的”。有了这个基础，我们尝试让它更丰富一些。
文字有结构：TextFrame和Paragraphs
刘姐在做上一周的汇报时，想分点列一下各项业务数据，发现首航点成了"业务数据"几个大字儿，后续想加上小标题就得手动换行。
这背后涉及到了python-pptx里一个非常关键的点：文本框内部不是扁平的，而是存在一个三层级的嵌套关系。最外层的容器是TextFrame，它决定整个容器的各种行为；容器内部又可以包含多个段落Paragraph，每个段落拥有一套独立的排版样式；段落内部还可以切分成多个“语句块”Run，用来控制局部的文字细节。
通俗点，你可以把写字这件事想象为：
- 整个PPT画好的框子：类似于真实的黑色硬壳笔记本封面，只能打开或合上。
- 每一页笔记本内页：就像我们的
TextFrame，决定这一页用横线条纹、格子还是白纸。 - 每个英文小方块：就像一个个独立的小方块，占据独立的位置。
理解了这三层的结构，就能在PPT里随心所欲地写字，因为大多数复杂的排版效果都要用到这三层的配合。
举个例子，我想在同一个文本框里写两段话，第一段普通文字左对齐，第二段的特定几个词涂成红色：
from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.text import PP_ALIGN
from pptx.dml.color import RGBColor
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])
textbox = slide.shapes.add_textbox(Inches(1), Inches(1), Inches(8), Inches(3))
frame = textbox.text_frame
frame.text = "这是第一段"
frame.paragraphs[0].alignment = PP_ALIGN.CENTER
p2 = frame.add_paragraph()
p2.text = "分析数据后发现："
run = p2.add_run()
run.text = "核心KPI"
run.font.bold = True
run.font.color.rgb = RGBColor(255, 0, 0)
run2 = p2.add_run()
run2.text = " 提升20%，超出预期。"
prs.save("层次结构示例.pptx")
运行后你就会看到，第一段被居中对齐，“核心KPI”变成了红色加粗。刘姐拿着这个提效成果开周会的时候，台下看PPT的人会直观感觉到关键数字在发亮。
这种按层次拆解的方式在代码里执行时会感觉过于机械，但好处也非常明显——排版效果极稳，很少出意外。
字体、颜色和对齐，一次调全站
很多人写周报时一个非常耗时的操作是每页都反复调字体大小、颜色、加粗和解锁。咱们来看看python-pptx里如何一次性把这些细节自动搞定。
from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.text import PP_ALIGN
from pptx.dml.color import RGBColor
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])
textbox = slide.shapes.add_textbox(Inches(1), Inches(1), Inches(6), Inches(2))
frame = textbox.text_frame
p = frame.paragraphs[0]
run = p.add_run()
run.text = "2026年春季营收报告"
# 粗体、字体名称、字号、颜色、居中
run.font.bold = True
run.font.name = "微软雅黑"
run.font.size = Pt(32)
run.font.color.rgb = RGBColor(0, 112, 192)
p.alignment = PP_ALIGN.CENTER
prs.save("字体颜色示例.pptx")
代码里的Pt(32)意思是字号32磅。数字越大字越大。RGBColor里面括号的三个数字分别代表红、绿、蓝的深度，取值范围0到255。比如RGBColor(255,0,0)就是最纯的红色，RGBColor(0,255,0)是鲜绿，RGBColor(0,0,255)是亮蓝。
在段落层面除了居中对齐（CENTER），还可以选择左对齐（LEFT）、右对齐（RIGHT）和两端对齐（JUSTIFY），每种都对应PP_ALIGN枚举里不同的常量。
公司如果有统一的设计规范（比如标题用微软雅黑、正文字号24磅、二级页眉用18磅带下划线），完全可以把这些样式抽出来写成配置，用循环直接应用到每一页。省时又规范。
行距、边距和自动换行的精细控制
光会改字体颜色还远远不够，真正把文本摆放得恰到好处，还需掌握两样武器：段落行距（Line Spacing）和文本框内边距（Margin）。比如很多人写PPT时有一个傻习惯，为了让排版不那么挤，每段文字后狂按回车，留出一堆空白行。用代码就完全不需要这么做，你直接设定段落行距就行。
要设置段内某一段的行距，需要借助LineSpacing对象。不过当前正式版的python-pptx暂时不能<行距>，我后来在文档发现一个可行的小技巧——先用paragraph的space_before和space_after属性控制段落之间的间距：
from pptx.util import Pt
...
p = frame.add_paragraph()
p.text = "严格来说，每个段落的头尾都可以自定义间距"
p.space_before = Pt(12) # 段前留白12磅
p.space_after = Pt(12) # 段后留白12磅
官方文档在需要精确调整时可以用space_before和space_after来打出舒服的呼吸感。另外如果要设置页边距，可以直接设定text frame对象的四种边距值：
frame.margin_left = Inches(0.2)
frame.margin_right = Inches(0.2)
frame.margin_top = Inches(0.1)
frame.margin_bottom = Inches(0.1)
还有一个极其友好的功能是自动换行和高度自适应：
frame.word_wrap = True # 文字超出自动换行
frame.auto_size = MSO_AUTO_SIZE.SHAPE_TO_FIT_TEXT # 高度自适应
尤其是在写数据分析结论时，有时候某一段文字特别长，刚才这些开关能自动把文字完整显示出来，不用手动增删文本框。
项目符号与多级列表：让数据分条更清晰
刘姐每次写周报都要把“数据指标”这页分四五个小点突出展示，手动弄项目符号要一个个按tab和backspace键，效率极低。其实python-pptx对项目符号和列表的支持非常完善，而且控制它的核心是两个属性：paragraph.bullet开关和paragraph.level层级。
from pptx import Presentation
from pptx.util import Inches
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])
textbox = slide.shapes.add_textbox(Inches(1), Inches(1), Inches(6), Inches(3))
frame = textbox.text_frame
frame.clear() # 清理默认段落，防止覆盖
items = [
("分析概览", 0),
(" 第一季度营收同比上涨9%", 1),
(" 华北区涨幅达15%", 2),
(" 销售成本下降12%", 1),
(" 主要来自高效的供应链优化", 2),
]
for content, level in items:
p = frame.add_paragraph()
p.text = content
p.level = level # 0代表最外层（一级），数字越大缩进越深
prs.save("多级列表示例.pptx")
level控制缩进深度：0级项靠左突出主标题，1级代表次一级分论点，2级甚至可以写更细节的数据支撑。这种多级结构阅后一目了然，非常适合用来写结论PPT的逻辑框架。
完整的周报生成脚本
汇总刚才的所有知识点，我们一起写一段能直接帮刘姐每周生成周报的完整脚本：
from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.text import PP_ALIGN
from pptx.dml.color import RGBColor
def generate_weekly_report(week_num, kpi_data, analysis_list):
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[6])
# 标题区
title_textbox = slide.shapes.add_textbox(Inches(1), Inches(0.5), Inches(8), Inches(1))
title_frame = title_textbox.text_frame
title_frame.text = f"第{week_num}周运营周报"
run_title = title_frame.paragraphs[0].runs[0]
run_title.font.bold = True
run_title.font.size = Pt(32)
run_title.font.name = "微软雅黑"
title_frame.paragraphs[0].alignment = PP_ALIGN.CENTER
# KPI 核心数据框（红色高亮显示）
kpi_textbox = slide.shapes.add_textbox(Inches(1), Inches(2), Inches(8), Inches(1))
kpi_frame = kpi_textbox.text_frame
kpi_para = kpi_frame.paragraphs[0]
kpi_para.text = "核心经营数据："
run_kpi = kpi_para.add_run()
run_kpi.text = f" {kpi_data}"
run_kpi.font.bold = True
run_kpi.font.color.rgb = RGBColor(255, 0, 0)
run_kpi.font.size = Pt(24)
# 分析列表区（分页展示每一段观点）
analysis_textbox = slide.shapes.add_textbox(Inches(1), Inches(3.5), Inches(8), Inches(3.5))
analysis_frame = analysis_textbox.text_frame
analysis_frame.clear()
for title, detail in analysis_list:
p = analysis_frame.add_paragraph()
p.text = f"{title}：{detail}"
p.level = 0
p.space_before = Pt(10)
p.font.size = Pt(16)
p.font.name = "微软雅黑"
if "同比" in detail or "环比" in detail:
run_range = p.runs[-1] if p.runs else p.add_run(detail)
run_range.font.bold = True
prs.save(f"第{week_num}周运营周报.pptx")
print(f"✅ 第{week_num}周运营周报生成完毕！")
# 实际使用时，传入每周变化的参数
generate_weekly_report(
week_num=18,
kpi_data="周活用户环比增长18%，GMV突破860万",
analysis_list=[
("用户增长", "新注册用户2.8万，同比增长12%"),
("渠道表现", "抖音渠道转化率提升至6.7%"),
("产品改进", "上线搜索功能后转化率短期提升5%"),
]
)
这段脚本在真实世界里跑起来，可以实现三件事：标题区居中对齐，核心KPI数据红色大号显示，分析观点自动按条排列保证清爽效果。刘姐以后只用改数字，其他排版全都交给代码。
避坑指南：实操里经常翻车的四件事
经过前面这么多操作思路的演示，再看几个比较隐蔽的陷阱吧，提前避开才能在项目里顺畅运行。
1. 修改现有文本框内容时格式丢失
如果你用text_frame.text = "新文字"覆盖原有的内容，极大概率会导致字体、段内样式和你之前精心设置的格式全部丢失。建议增量处理：使用clear()清空段落池，然后调用add_paragraph()新建各类段落和Run，始终在每个Run对象里明确指定样式，确保新内容的展现精准复制。
2. 默认段落留底且位置覆盖
新建一个文本框时，自带的paragraphs里其实已经有一个空段落。如果你直接调用add_paragraph()追加内容，可能会发现这个空段落占掉了第一行，导致排版错位。解决办法是开局先调用text_frame.clear()，“清空重置，无债一身轻”。
3. 中文显示小方框
老问题每年都把人坑惨。你生成的PPT里，“正式”两个字显示成了两个整整齐齐的小方块。python-pptx本身对中文支持良好，但前提是你要明确告诉PPT使用安装了什么字体库。例如在代码里写run.font.name = "微软雅黑"，Win系统自带的雅黑基本都能正常呈现。Mac则建议换成"PingFang SC"。如果是Linux服务器需要渲染中文，记得提前装文泉驿或其他中文字体。
4. positioning和margin数值调错
add_textbox的left值和容器的左边界中间隔着一段缓冲内缩，不要误以为left=Inches(0)文字就顶格。如果想实现顶格，你应该调低left值（例如Inches(-0.1)），然后靠margin_left压缩内容的起始位置。
离自动化办公只差最后一步
文章到这儿告一段落，刘姐现在每周五只花几分钟跑一下脚本，生成一份干净整洁的数据周报，把精力全部放在分析数据上，而不是拖着文本框来回摆位置。工具越小，事情越稳。
python-pptx能做的事远不止这些。比如你还可以用它批量替换模板里的占位符，给几十页PPT插入图表，或者根据Excel里的数据表格自动生成汇报。
