python-pptx 自动化生成初升高数学衔接 PPT 课件

简介：这份《初升高数学衔接PPT课件》定位为专业课件，面向即将升入高中或刚进入高一的学生、家长及数学教师，用于弥补初中到高中在知识深度、教学节奏与思维要求上的落差。课件围绕高中数学学习特点展开，涵盖预习课本、认真听讲、课后复习、建立错题库等习惯养成建议，并强调“三个一遍”的重复学习原则；在知识层面梳理平方差、完全平方、立方和与立方差公式、分组分解法、十字相乘法以及二次三项式因式分解，同时介绍数学归纳法、参数法、消去法和函数与方程、数形结合、分类讨论、转化化归等思想方法，配有例题讲解与推导过程。资源包内含1个pptx文件，约393KB，共33页，便于课堂演示或自主阅读。目前已有120人学习下载，适合作为暑期衔接自学、教师备课或高一入学适应性训练的参考课件。

1. 初升高数学衔接 PPT 课件：把一份课件当成可编译的产物

初升高数学衔接这件事，落到工程上就是一份几十页的.pptx：封面、初中知识回顾、新高一知识引入、例题精讲、随堂练习、课后作业，每一讲都重复这套结构。带过衔接班的老师大概率经历过这个过程——每周把上一讲的课件另存一份，改标题、换例题、重新截图函数图象，改到第三周就开始出现两类事故：例题还是上一讲的，公式截图放大后糊成一片。把这份.pptx交给代码生成，收益不在省几次复制粘贴，而在于内容和排版彻底解耦：一节课的内容写进一份 YAML，版式、字体、公式、函数图象交给模板和渲染脚本统一负责。下面按「先看清文件结构，再搭最小骨架，再解决公式和图象，最后批量产出与质检」的顺序走一遍，环境是 Python 3.10 以上，Office 2016 以上或新版 WPS 用来验证放映效果。

2. 拆开 .pptx：初升高数学衔接课件的内容骨架与 OOXML 结构

2.1 先定内容骨架，再谈代码

衔接课件的结构高度固定，先把它固化成表，后面所有脚本都围绕这张表写。常见的一讲 18 到 22 页，板块划分如下：

板块	建议页数	使用的版式	内容来源
封面	1	标题幻灯片	YAML 里的 title / subtitle
学习目标	1	标题和内容	3 到 4 条，动词开头
初中知识回顾	3 到 4	标题和内容	因式分解、一元二次方程、函数概念
新课引入	3 到 4	标题和内容 + 图片	配函数图象
例题精讲	5 到 6	标题和内容	题干 + 分步解答
随堂练习	2 到 3	标题和内容	留白，课上写
课后作业	1	标题和内容	5 到 8 题

这张表的价值在于：它把「一节课」变成「一个数组」。只要 YAML 里按板块填内容，页数、顺序、版式都不用再手工调。

2.2 用命令行看清一份课件的组成

.pptx本质是一个 zip 包，里面全是 XML。动手改之前先看一眼目录，比对着一份手动做好的课件看，比读规范快得多：

# 只看文件列表，确认结构 unzip -l "初升高数学衔接PPT课件.pptx" # 解到临时目录看 XML 内容 unzip -o "初升高数学衔接PPT课件.pptx" -d _unpack # 找出页数最多的那几个 slide，通常就是例题页 wc -c _unpack/ppt/slides/*.xml | sort -n | tail -5

解出来的目录里，ppt/slides/slideN.xml是每页内容，ppt/slideLayouts/是版式，ppt/slideMasters/是母版，ppt/theme/theme1.xml定义配色和字体方案，ppt/media/放所有图片。改课件体积最大的一块永远是ppt/media——例题里的函数图象截图往往占了 80% 以上的体积。

2.3 母版、版式、占位符：不要从空白页手搓文本框

最容易被忽略的一点：手搓文本框看起来自由，实际是排版失控的根源。文本框的位置、字号、行距全部写死在页级 XML 里，模板一换全乱。正确做法是复用母版上的占位符，让字号、颜色、项目符号层级由主题决定。

slide_layouts的索引在不同模板里不一样，靠索引取值迟早出错，按版式名取更稳：

from pptx import Presentation prs = Presentation("template.pptx") # 打印所有版式名和版式里的占位符，先摸清模板 for i, layout in enumerate(prs.slide_layouts): holders = [(ph.placeholder_format.idx, ph.placeholder_format.type, ph.name) for ph in layout.placeholders] print(i, layout.name, holders)

输出里idx是占位符编号，0通常是标题，1是内容区。ph.name会直接告诉你它是「标题」还是「内容占位符 2」。把这几行打印出来贴进脚本注释里，后面写渲染循环时就不用反复试索引了。

提示：如果还没做模板，最省事的办法是先用 PowerPoint 手工做一页标准「标题和内容」，把字体、行距、项目符号调好，另存为template.pptx，再删掉这一页的内容，让它变成纯版式。比用代码从零调字体快得多。

3. 用 python-pptx 生成初升高数学衔接 PPT 课件的可运行骨架

3.1 环境与最小可跑命令

先把依赖装齐。python-pptx负责读写 pptx，PyYAML读内容配置，matplotlib画函数图象：

python -m pip install python-pptx pyyaml matplotlib python -c "import pptx; print(pptx.__version__)"

最小可跑的例子，先确认模板能被打开、占位符能填字：

from pptx import Presentation from pptx.util import Pt prs = Presentation("template.pptx") # 用第 2 个版式（通常是标题和内容），实际按上一节打印出的名字挑 layout = next(l for l in prs.slide_layouts if "内容" in l.name) slide = prs.slides.add_slide(layout) slide.shapes.title.text = "第二讲 二次函数的图象与性质" body = slide.placeholders[1] tf = body.text_frame tf.text = "回顾：y = ax² + bx + c 的开口方向由 a 的符号决定" p = tf.add_paragraph() p.text = "配方后顶点式为 y = a(x + b/2a)² + (4ac - b²)/4a" p.level = 1 # 二级项目符号 prs.save("out.pptx")

前三行是打开模板并挑版式，add_slide会在末尾追加一页。tf.text写第一段，add_paragraph()之后每一段都要重新赋值p.text并设置p.level，level=0是一级、1是二级。这里没有手工设置任何位置和字号，全部继承自版式，这是后面能批量生成的前提。

3.2 中文字体、字号、行距的三个必调参数

python-pptx设置字体时只写了a:latin，中文实际走的是a:ea节点，所以会出现「英文字体生效、中文没变」的情况。要三个都写：

from pptx.util import Pt from pptx.oxml.ns import qn def set_run_font(run, name="微软雅黑", size=Pt(20), bold=False): run.font.name = name # 写入 a:latin run.font.size = size run.font.bold = bold rPr = run._r.get_or_add_rPr() rFonts = rPr.find(qn("a:rFonts")) # font.name 一定创建了它 for tag in ("a:ea", "a:cs"): el = rFonts.find(qn(tag)) if el is None: el = rFonts.makeelement(qn(tag), {"typeface": name}) rFonts.append(el) el.set("typeface", name)

a:ea管东亚字形，a:cs管复杂文种，三个都指向同一个字体名，中文和数字符号才一致。参数上，衔接课件正文建议 20 到 24 磅，例题解答 18 磅，投影距离远的教室不要再往下压。

行距要在段落级别调，python-pptx没有直接属性，走 XML：

def set_line_spacing(paragraph, multiple=1.4): pPr = paragraph._p.get_or_add_pPr() lnSpc = pPr.makeelement(qn("a:lnSpc"), {}) spcPct = pPr.makeelement(qn("a:spcPct"), {"val": str(int(multiple * 100000))}) lnSpc.append(spcPct) pPr.insert(0, lnSpc) # 顺序必须靠前，否则 PowerPoint 忽略 set_line_spacing(p, 1.4)

val是千分之一百分比，1.4倍写成140000。lnSpc必须插在pPr的开头，插到末尾的话 PowerPoint 会直接不认这个行距——这条路走错的人不少，打开文件没报错但行距纹丝不动。

注意：标题字号不要低于 32 磅，例题页正文低于 18 磅时后排基本看不清。脚本里把这两个数字做成常量，批量生成时一眼能看出哪节课超了。

3.3 用 YAML 描述一节课，渲染成幻灯片

把内容抽出来放进 YAML，渲染脚本只管遍历。一讲的配置大致长这样：

title: 第二讲 二次函数的图象与性质 subtitle: 初升高数学衔接 · 暑期第 2 次 slides: - title: 学习目标 bullets: - 会用配方法把一般式化成顶点式 - 能根据 a 的符号判断开口方向 - 会求抛物线的顶点坐标与对称轴 - title: 初中回顾 bullets: - 因式分解：x² - 2x - 3 = (x - 3)(x + 1) - 一元二次方程 ax² + bx + c = 0 的求根公式 - title: 例题 1 bullets: - 求 y = x² - 2x - 3 的顶点坐标与对称轴 - 配方：y = (x - 1)² - 4 figure: fig_quad.png

渲染循环负责把每个slides元素变成一页：

import yaml from pptx import Presentation cfg = yaml.safe_load(open("lesson02.yaml", encoding="utf-8")) prs = Presentation("template.pptx") cover = next(l for l in prs.slide_layouts if "标题" in l.name) content = next(l for l in prs.slide_layouts if "内容" in l.name) s = prs.slides.add_slide(cover) s.shapes.title.text = cfg["title"] s.placeholders[1].text = cfg["subtitle"] for item in cfg["slides"]: s = prs.slides.add_slide(content) s.shapes.title.text = item["title"] tf = s.placeholders[1].text_frame tf.clear() # 清掉占位符自带的空段 for i, line in enumerate(item["bullets"]): p = tf.paragraphs[0] if i == 0 else tf.add_paragraph() p.text = line p.level = 0 if item.get("figure"): s.shapes.add_picture(item["figure"], Inches(5.6), Inches(2.6), width=Inches(5.2))

tf.clear()不能省，否则第一行前面会多一个空段落，页面上就是一段莫名其妙的空行。item.get("figure")用get而不是下标，是因为大部分页没有配图。这段跑通之后，一节课的页面结构就完全由 YAML 决定了。

4. 公式与函数图象：初升高数学衔接课件里最难的排版部分

4.1 三种公式落地方式的取舍

衔接课件里的公式分两类：短的行内式（y = ax² + bx + c）和带分式、根号、上下标的大公式。落地方式有三条路，选错了后期返工成本很高：

方式	可编辑性	字号跟随主题	实现成本	适用场景
Unicode 字符直接写	高	是	最低	上标下标、简单符号
OMML 公式对象	高	是	高	需要后期微调的重点公式
matplotlib 渲图插入	无	否	中	分式嵌套、矩阵、图象

我一般的做法是：能在 Unicode 里写对的就用ax²+bx+c、√3、≤、≠直接写，覆盖七成场景；分式、根式这种 Unicode 撑不住的，用 matplotlib 渲成透明底 PNG 插入，投影效果最稳；只有极少数需要讲课时现场改数字的公式，才走 OMML。

4.2 用 a14:m 注入 OMML 公式

PowerPoint 2010 之后的公式存放在段落里的a14:m元素中，它包裹标准的m:oMathPara。手写一段分式插进标题占位符：

from pptx.oxml import parse_xml from pptx.oxml.ns import qn from lxml import etree NS_A14 = "http://schemas.microsoft.com/office/drawing/2010/main" NS_M = "http://schemas.openxmlformats.org/officeDocument/2006/math" omml = f'''<a14:m xmlns:a14="{NS_A14}" xmlns:m="{NS_M}"> <m:oMathPara><m:oMath> <m:r><m:t>y=a(x+</m:t></m:r> <m:f> <m:num><m:r><m:t>b</m:t></m:r></m:num> <m:den><m:r><m:t>2a</m:t></m:r></m:den> </m:f> <m:r><m:t>)²+</m:t></m:r> </m:oMath></m:oMathPara> </a14:m>''' para = slide.placeholders[1].text_frame.paragraphs[0] para._p.append(parse_xml(omml))

m:f是分式，m:num是分子、m:den是分母，m:r是文本运行、m:t是内容。这段结构照抄即可，只是把文字换成自己的。两处必须注意：一是a14命名空间的版本标记要正确，写错 PowerPoint 打开会提示修复；二是官方生成的文件里整个p:txBody外面还包了一层mc:AlternateContent，Choice放公式版、Fallback放纯文本版，只 append 公式节点属于简化写法，用 Office 2016 以上一般能认，但跨版本分发时风险自担。

提示：折中方案是先在 Word 里用公式编辑器写好，复制进 PowerPoint 一页，另存为.pptx，解包看slideN.xml里a14:m的真实结构，再照着这个结构批量替换。比自己拼 XML 可靠得多。

4.3 matplotlib 画函数图象并插入

抛体、抛物线、反比例函数这些图，用 matplotlib 画比手工截图清晰得多。中文字体和负号是两个必设项：

import matplotlib matplotlib.use("Agg") # 无界面环境必须 import matplotlib.pyplot as plt import numpy as np plt.rcParams["font.sans-serif"] = ["Microsoft YaHei", "SimHei"] plt.rcParams["axes.unicode_minus"] = False # 负号不显示成方块 plt.rcParams["mathtext.fontset"] = "stix" # 数学字体与中文共存 x = np.linspace(-3, 5, 400) y = x**2 - 2*x - 3 fig, ax = plt.subplots(figsize=(6, 4), dpi=200) ax.plot(x, y, lw=2, color="#1F4E79") ax.axhline(0, color="#999", lw=1) ax.axvline(0, color="#999", lw=1) ax.plot([1], [-4], "o", color="#C00000") # 顶点 ax.annotate("顶点 (1, -4)", xy=(1, -4), xytext=(1.6, -3), arrowprops=dict(arrowstyle="->", color="#C00000")) ax.grid(alpha=0.3, linestyle="--") ax.set_title(r"$y=x^2-2x-3$") fig.tight_layout() fig.savefig("fig_quad.png", dpi=200, transparent=True, bbox_inches="tight")

dpi=200配合幻灯片上 5 英寸左右的插入宽度，投影到 100 寸幕布依然清晰。transparent=True让图片背景透明，插到深色主题页面上不会出现白底方块。bbox_inches="tight"去掉四周多余留白，否则图片自带的空白会挤占正文位置。

插入时只给width或只给height，给两个参数会强制拉伸变形：

slide.shapes.add_picture("fig_quad.png", Inches(5.6), Inches(2.6), width=Inches(5.2))

4.4 公式与图的常见坑

第一类坑是字号不跟随。图片形式的公式字号被像素焊死了，模板一换主题字号，正文变了、图没变，一页里出现两种视觉重量。规避办法是统一以「图宽 = 正文区宽度 × 0.8」插入，字体大小按最终物理尺寸反推：幻灯片正文区宽 8 英寸，图片占 5.2 英寸，matplotlib 里字号 12 磅放大后约等于 18.5 磅，正好和例题正文对齐。

第二类坑是上标写错。x²用的是 Unicode 上标字符，看着对，实际字号和基线都跟正文不一致。真需要精确上标时，用 OMML 的m:sSup结构，或者直接在 matplotlib 里渲染。

第三类坑是透明底图放进浅色背景后边缘发灰。这是缩放算法导致的，解决办法是把dpi提到 300，把最终尺寸控制在插入宽度的 1.5 倍以内，不要指望幻灯片自动重采样。

5. 批量产出与交付质检：初升高数学衔接 PPT 课件的收尾技巧

5.1 一次生成一整套，命名带上讲次

一整套衔接课件通常是 12 到 16 讲，用目录驱动一次跑完，文件名带上讲次便于排序：

import glob, os, yaml from pptx import Presentation for path in sorted(glob.glob("lessons/*.yaml")): cfg = yaml.safe_load(open(path, encoding="utf-8")) out = f"dist/第{cfg['no']:02d}讲_{cfg['title']}.pptx" render(cfg, "template.pptx", out) # render 即第 3 章的渲染循环 print(out, round(os.path.getsize(out) / 1048576, 2), "MB")

f"{cfg['no']:02d}"补零是为了让文件管理器按 01、02、…、10 排序，而不是 1、10、2。顺手打印体积，超过 20 MB 的基本都是图片没压缩。

5.2 交付前的三项检查

残留占位符、字体缺失、体积超标是三个最常见的交付事故，都能脚本化扫出来：

from pptx import Presentation BAD = ("单击此处添加", "Click to edit", "母版样式") path = "dist/第02讲_二次函数.pptx" for i, s in enumerate(Presentation(path).slides, 1): for sh in s.shapes: if sh.has_text_frame and any(b in sh.text_frame.text for b in BAD): print("残留占位符", i, sh.text_frame.text[:20])

扫不到残留之后，还要在目标机器上打开一次确认字体。python-pptx不支持嵌入字体，微软雅黑在 Mac 上会 fallback 成别的字形，跨平台分发的稳妥做法是把字体换成思源黑体这类可自由分发的中文字体，或者干脆在任意机器上都用系统默认。

体积压缩走图片重压这条路，注意[Content_Types].xml必须在包根目录：

unzip -o "dist/第02讲_二次函数.pptx" -d _x find _x/ppt/media -name "*.png" -size +200k -exec convert {} -strip -quality 85 {} \; cd _x && zip -r -X "../dist/第02讲_二次函数_slim.pptx" . && cd .. ls -lh dist/*.pptx

-strip去掉 PNG 里的元数据，-size +200k只处理大图，小图标别动，重压反而更糊。

5.3 用一次 PDF 转换做放映预检

最后一道关不看 pptx，看渲染结果。用 LibreOffice 无头模式批量导 PDF，翻一遍就能发现图片变形、文字溢出、公式错位：

soffice --headless --convert-to pdf --outdir preview/ dist/*.pptx pdfinfo preview/第02讲_二次函数.pdf | grep Pages

页数对得上，就说明每一页都被正常渲染；某页在 PDF 里出现大片空白，通常是那一页的图片路径没找到或者占位符被清空后没填内容。这个检查放在批量生成之后、打包分发之前，比事后被听课老师指出「第 14 页是空的」要划算得多。

本文还有配套的精品资源，点击获取