Python实现PPT创建文本框并设置格式的完整步骤

刘姐是公司的行政主管，每周雷打不动要给全公司做周报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.sa ve("我的第一个文本框.pptx")

刚开始，你可能会对这些数字的意义犯嘀咕。其实add_textbox方法里的四个参数，分别控制的是文本框离左侧的距离、离顶部的距离、宽度和高度。修改这些数值，就能精确控制文本的位置。

跑一遍上面的代码，生成的PPT里就会多一页空白页，上面静静地躺着一个文本框，写着“我是自动生成的”。有了这个基础，我们再让它变得更丰富些。

文字有结构：TextFrame和Paragraphs

刘姐在做上一周的汇报时，想把几项业务数据分点列出来。结果发现，标题“业务数据”是一个大字，后面想加小标题就得手动换行，特别麻烦。

这背后其实涉及到了python-pptx里一个非常关键的概念：文本框内部不是扁平的，而是存在一个三层级的嵌套关系。最外层的容器是TextFrame，它决定了整个容器的各种行为；容器内部又可以包含多个段落Paragraph，每个段落都有一套独立的排版样式；而段落内部，还可以继续切分成多个“语句块”Run，用来控制局部的文字细节。

打个比方，你可以把在PPT里写字想象成这样：

• 整个PPT画好的框子：就像一本笔记本的硬壳封面，决定了它的存在。
• 每一页笔记本内页：就像我们的TextFrame，决定了这一页是横线、格子还是白纸。
• 页面上的每一行字：就像Paragraph，占据一个独立的位置，可以有自己的对齐方式。

理解了这三层结构，在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.sa ve("层次结构示例.pptx")

跑一遍你就能看到，第一段被置中了，而“核心KPI”这几个字变成了红色加粗。刘姐拿着这个成果去开周会，台下看PPT的人一眼就能抓住关键数字。

这种按层次拆解的方式，写代码的时候会觉得有点“机械”，但好处也显而易见——排版效果极其稳定，很少出bug。

字体、颜色和对齐，一次调全站

很多人写周报时，最耗时的操作就是每页反复调字体大小、颜色、加粗。咱们来看看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.sa ve("字体颜色示例.pptx")

代码里的Pt(32)意思是字号32磅。数字越大字越大。RGBColor里括号的三个数字分别代表红、绿、蓝的深度，取值范围0到255。比如RGBColor(255,0,0)就是最纯的红。

在段落层面，除了居中对齐（CENTER），还可以选择左对齐（LEFT）、右对齐（RIGHT）和两端对齐（JUSTIFY）。

公司如果有统一的设计规范（比如标题用微软雅黑、正文字号24磅、二级页眉用18磅带下划线），完全可以把这些样式抽出来写成配置，用循环直接应用到每一页。省时还规范。

行距、边距和自动换行的精细控制

光会改字体颜色还不够，真正让文本摆放得恰到好处，还需要掌握两样武器：段落行距和文本框内边距。很多人写PPT时有个傻习惯，为了让排版不显得拥挤，每段文字后狂按回车，留出一堆空白。用代码就完全不用这样，直接设定段落间距就行。

要设置段落间距，可以使用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.sa ve("多级列表示例.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.sa ve(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 = "微软雅黑"，Windows系统自带的雅黑基本都能正常显示。Mac系统则建议换成"PingFang SC"。如果你是在Linux服务器上跑，记得提前装好文泉驿或其他中文字体。

4. positioning和margin数值调错

add_textbox的left值和容器的左边界之间，其实是隔着一段缓冲内缩的。不要误以为left=Inches(0)文字就顶格了。如果你想实现顶格效果，应该将left值调低（比如Inches(-0.1)），然后靠margin_left来压缩内容的起始位置。

离自动化办公只差最后一步

好了，文章到这儿就告一段落了。现在的刘姐，每周五只花几分钟跑一下脚本，就能生成一份干净整洁的数据周报。她把精力全部放在分析数据上，再也不用拖着文本框来回摆位置了。你看，工具越小，事情反而越稳。

python-pptx能做的事远不止这些。比如，你还可以用它批量替换模板里的占位符，给几十页PPT插入图表，或者根据Excel里的数据自动生成一份汇报。打开这扇门，你会发现一个全新的世界。