小张是个运营，每周五都要做数据周报。
每次打开PPT，新建一页，拖一个文本框进来，调字号、改字体、居中、加粗、换颜色……十几页PPT做下来，大半个下午就没了。
最烦的是，下周还要再来一遍。
她问我：“这些重复操作，能不能让代码帮我做？”
能。Python里有个库叫python-pptx，专门干这事儿。
你可能会想：“我连PPT都没玩明白，还让我写代码？”
别急。做PPT的重复操作，本质上就是三件事：在哪放文本框、写什么字、字长什么样。用代码写一遍，以后每次运行就行，连格式刷都省了。
先搭个最简单的框
你只需要四行代码，就能生成一个文本框。
from pptx import Presentation
from pptx.util import Inches
新建PPT（或者打开现有的）
prs = Presentation()
加一页空白幻灯片
slide = prs.slides.add_slide(prs.slide_layouts[6])
画个文本框：离左边1英寸，离上边1英寸，宽5英寸，高2英寸
textbox = slide.shapes.add_textbox(Inches(1), Inches(1), Inches(5), Inches(2))
写点字进去
textbox.text_frame.text = "我是自动生成的"
保存
prs.save("我的第一个文本框.pptx")
跑一下这段代码，打开生成的PPT，你会在空白页的左上角看到一个文本框。
这里有个概念叫“坐标系统”。PPT里所有东西的位置，都是用英寸（Inches）或者厘米（Cm）来定的。add_textbox的四个参数分别是：
你可以把这些数字随便改，比如Inches(2)就是两英寸。改完再跑一遍，框的位置和大小就变了。
别把字都挤在一起：理解三层结构
你可能会遇到一个情况：在一个文本框里写了好几行字，想单独调整其中一行的样式，发现调不了。
这就涉及到python-pptx里文本的核心结构了。它有三层：
TextFrame（文本框容器）：最外层，管整个框的行为，比如边距、垂直对齐、是否自动换行。
Paragraph（段落）：中间层，管一段话的行为，比如对齐方式、行间距、项目符号层级。
Run（文字块）：最内层，真正管文字长什么样，比如字体、字号、颜色、粗体斜体。
简单说：一个文本框里可以有多个段落，一个段落里可以有多个Run。
为什么要有Run？因为一段话里可能既有普通文字又有加粗红色文字。Run就是用来实现这种“混搭”的。
下面这段代码展示了这三层怎么配合：
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，只让"重点"两个字变色
run = p2.add_run()
run.text = "重点"
run.font.bold = True
run.font.color.rgb = RGBColor(255, 0, 0) # 红色
run.font.size = Pt(18)
继续加普通文字
run2 = p2.add_run()
run2.text = " 后面的普通文字"
prs.save("三层结构演示.pptx")
跑完这段，你会看到：第一段居中，第二段里“重点”两个字又大又红又粗，后面的文字保持原样。
这就是Run的威力——精细控制。
让文字更好看：字体、字号、颜色、对齐
做PPT的人都知道，好看的排版离不开这些细节。python-pptx基本都支持。
字体和字号：
run = frame.paragraphs[0].add_run()
run.text = "Hello"
run.font.name = "微软雅黑" # 字体名
run.font.size = Pt(24) # 字号，单位是磅
粗体、斜体、下划线：
run.font.bold = True # 加粗
run.font.italic = True # 斜体
run.font.underline = True # 下划线
颜色：
from pptx.dml.color import RGBColor
RGB颜色，三个数字分别代表红绿蓝，范围0-255
run.font.color.rgb = RGBColor(255, 0, 0) # 红色
run.font.color.rgb = RGBColor(0, 112, 192) # 一种蓝色
段落对齐：
from pptx.enum.text import PP_ALIGN
paragraph.alignment = PP_ALIGN.CENTER # 居中
paragraph.alignment = PP_ALIGN.LEFT # 左对齐
paragraph.alignment = PP_ALIGN.RIGHT # 右对齐
文本框级别的设置（整个框的垂直对齐、边距、自动换行）：
from pptx.enum.text import MSO_ANCHOR, MSO_AUTO_SIZE
frame.vertical_anchor = MSO_ANCHOR.MIDDLE # 文字在框里垂直居中
frame.margin_left = Inches(0.2) # 左边距
frame.margin_top = Inches(0.1) # 上边距
frame.word_wrap = True # 自动换行
frame.auto_size = MSO_AUTO_SIZE.SHAPE_TO_FIT_TEXT # 根据文字自动调整框大小
这些设置混在一起用，基本能实现PPT里95%的排版需求。
做出有层次感的文本：项目符号和多级列表
做PPT少不了要点列表。python-pptx支持自动生成项目符号，还能缩进。
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),
(" 营收增长25%", 1),
(" 主要来自华东区", 2),
(" 成本下降10%", 1),
]
for text, level in items:
p = frame.add_paragraph()
p.text = text
p.level = level # 0是最外层，数字越大缩进越多
# 默认就有项目符号，如果想关掉：
# p.bullet = False
prs.save("项目符号演示.pptx")
跑完这段，你会看到一个有层级缩进的列表，就像Word里的多级列表一样。
一个完整例子：批量生成周报
现在把小张的需求串起来。假设她要生成一份周报，包含三部分：标题、核心数据（加粗红色）、分析结论（项目符号）。
from pptx import Presentation
from pptx.util import Inches, Pt
from pptx.enum.text import PP_ALIGN
from pptx.dml.color import RGBColor
def create_report(report_title, key_number, conclusions):
prs = Presentation()
# 封面页
slide = prs.slides.add_slide(prs.slide_layouts[6])
# 标题框
title_box = slide.shapes.add_textbox(Inches(1), Inches(2), Inches(8), Inches(1))
title_frame = title_box.text_frame
title_frame.text = report_title
title_frame.paragraphs[0].alignment = PP_ALIGN.CENTER
title_frame.paragraphs[0].runs[0].font.size = Pt(32)
title_frame.paragraphs[0].runs[0].font.bold = True
# 核心数据框
data_box = slide.shapes.add_textbox(Inches(1), Inches(3.5), Inches(8), Inches(0.8))
data_frame = data_box.text_frame
data_frame.text = f"核心数据："
run = data_frame.paragraphs[0].add_run()
run.text = f" {key_number}"
run.font.bold = True
run.font.color.rgb = RGBColor(255, 0, 0)
run.font.size = Pt(20)
data_frame.paragraphs[0].alignment = PP_ALIGN.CENTER
# 分析结论页
slide2 = prs.slides.add_slide(prs.slide_layouts[6])
box = slide2.shapes.add_textbox(Inches(1), Inches(1.5), Inches(8), Inches(4))
frame = box.text_frame
frame.text = "分析结论："
frame.paragraphs[0].font.size = Pt(24)
frame.paragraphs[0].font.bold = True
for conclusion in conclusions:
p = frame.add_paragraph()
p.text = conclusion
p.level = 0
p.font.size = Pt(16)
prs.save("周报.pptx")
print("周报生成成功！")
调用函数
create_report(
"第45周运营周报",
"GMV突破500万",
["用户活跃度提升12%", "新客转化率创历史新高", "下周重点关注留存率"]
)
小张以后每周只需要改三个参数：标题、核心数字、结论列表。运行一下，几秒钟就能拿到一份格式统一的周报。
遇到模板怎么办？替换占位符
很多公司有自己的PPT模板，标题在固定位置，logo在固定位置。
python-pptx可以打开现有PPT，找到特定的占位符，替换里面的内容。
prs = Presentation("公司模板.pptx")
slide = prs.slides[0] # 取第一页
遍历这一页上所有的占位符
for shape in slide.placeholders:
print(f"占位符ID: {shape.placeholder_format.idx}, 名字: {shape.name}")
根据索引替换
slide.placeholders[0].text = "2025年Q1汇报"
slide.placeholders[1].text = "销售部"
prs.save("填好内容的汇报.pptx")
先跑一下打印占位符的代码，记下每个位置对应的ID，然后就可以用代码批量填充了。
几个容易踩的坑
坑一：修改已有文本框内容时，格式丢了
如果你拿到一个已有的文本框，直接text_frame.text = "新内容"，里面的格式会被清空。想保留格式，应该操作具体的段落和Run。
坑二：中文字体显示成方块
必须指定系统里存在的字体。Windows用"微软雅黑"或"SimHei"，Mac用"PingFang SC"。不指定的话，可能会用默认字体，中文就变成方块了。
坑三：文本框太小，字显示不全
设置text_frame.auto_size = MSO_AUTO_SIZE.SHAPE_TO_FIT_TEXT，文本框会自动撑大。或者设置text_frame.word_wrap = True让它自动换行。
坑四：添加多个段落时，第一段消失了
刚创建的文本框自带一个空段落。如果你调用add_paragraph()之前没有clear()，那第一段可能会被覆盖。保险做法：加内容之前先text_frame.clear()。
还能做什么？
掌握了文本框，python-pptx还能干更多事：
比如给100份产品介绍PPT统一加上公司logo和联系方式，手改要半天，用代码两秒跑完。
回到小张。她现在每周五上午花两分钟改改参数，然后去倒杯咖啡，回来周报就生成好了。
她说：“以前觉得会写代码的人很酷，现在发现会写代码的自己更酷。”
