简介这是一份面向通信、电子及计算机相关专业学习者与初学者的手机结构认知课件围绕手机外部按键接口、内部组件与核心硬件逐层展开可用于课堂教学、自学入门或硬件拆解前的知识铺垫。压缩包内共1个pptx文件约2.38MB以图文幻灯片形式呈现配合12页内容按模块讲解便于直接投影讲授或课后翻阅。课件从听筒、触摸键、MIC、音量键、充电/UsB接口、前后摄像头、扬声器、耳机接口、开机键、SIM卡槽与内存卡槽等外部结构讲起再延伸至LCD/TPLCD、前壳后壳与电池盖、电池、主板副板、距离感应器等内部组件并进一步介绍高通MSM8225处理器、Hynix海力士内存以及电源管理芯片、功率放大器、射频收发器等关键电子元件形成由外到内、由整机到元件的完整知识链条。目前已有124人学习适合需要快速建立手机软硬件整体认知、或为维修与电子技术课程做预习复习的读者参考。1. 一份手机功能及结构介绍PPT学习教案卡住人的往往不是知识点职校硬件基础课、售后工程师新人培训、拆解类公开课撞上的其实是同一件事手机功能与手机结构这些知识点本身不难难的是每学期都要重做一份能直接上课的 pptx。参数年年小改结构图年年要换成可编辑版本讲师备注还得跟 45 分钟课时严丝合缝最后往往变成「上课前一周熬夜贴图」。这份学习教案要解决的核心问题很具体把「手机由哪些结构件组成、每类结构件支撑什么用户功能、这些内容怎么在 45 分钟里讲完」变成一套结构固定、数据外置、能用脚本重新生成的课件。适合三类人要反复开这门课的讲师、给新人做硬件科普的测试与售后工程师、以及想用 python-pptx 把课件自动化的开发者。教案不是知识堆砌它是一个可复用、可校验、可版本管理的工程产物。2. 手机功能与结构知识点怎么拆进 45 分钟教案2.1 结构按「外到内四层」拆而不是按零件罗列初学者最容易被一串零件名劝退中框、后盖、盖板玻璃、FPC、屏蔽罩、均热板、线性马达。按零件讲学生记不住按层讲学生能自己推导。我一般会切成四层教学顺序就是拆机顺序也是用户认知顺序。第一层是外观与防护层包含盖板玻璃、中框、后盖。这一层决定了握持手感、重量分配、天线缝位置也是「为什么金属后盖会挡信号」这个经典问题的答案所在。第二层是显示与触控层包含 OLED 或 LCD 面板、触控感应层、偏光片与贴合胶。教学重点是「面板、触控、盖板三者贴合方式」——全贴合与非全贴合的差异会直接体现在厚度、进灰和反光上学生一摸真机就有感觉。第三层是主板与计算层包含 SoC、内存与闪存、射频前端、电源管理 IC、摄像头接口。这一层信息密度最高建议只讲清「哪些功能由哪块芯片负责」不要陷进制程和型号对比。第四层是能源、散热与声学层包含电芯、充电 IC、VC 均热板或石墨片、扬声器、马达。这一层是「性能释放」话题的落点跑分高不高看 SoC跑得久不久看散热和电池。四层拆完再回头讲整机装配顺序学生基本能把拆机视频看懂。这个顺序也方便做板书PPT 一页放一层翻页节奏和讲授节奏天然对齐。2.2 手机功能与结构件的对应关系表教案里最值钱的一页是「功能—结构件」映射表它把用户语言翻译成硬件语言。下表可以直接抄进 PPT也可以作为 YAML 数据源里的一张 section。用户可见功能主要结构件课堂演示点通信与上网射频前端、中框天线缝、天线调谐器握持姿势如何影响信号强度拍照与录像摄像头模组、ISP、OIS 马达像素数不等于画质传感器尺寸更关键续航与快充电芯、充电 IC、Type-C 接口双电芯串联与单电芯的充电曲线差异触控与交互触控层、线性马达、扬声器触觉反馈延迟与触控采样率的关系感知能力加速度计、陀螺仪、光线与霍尔传感器传感器融合为什么需要校准散热表现VC 均热板、石墨片、中框导热路径温度墙触发后频率如何回落表格的讲法有讲究。不要一页念完挑三行展开通信对应天线缝、拍照对应 OIS、续航对应电芯结构。剩下三行留作课后阅读教案里标注「自学页」学生带着问题看反而记得牢。2.3 45 分钟课时分配与提问设计课时分配不写进 PPT但必须写进教案文档否则讲起来一定前松后紧。常用节奏是导入 5 分钟结构四层 18 分钟功能映射 12 分钟互动与答疑 8 分钟作业布置 2 分钟。导入环节别用「今天我们来学习手机结构」这种开场。拿一台退役机模让学生先猜「这台机器最贵的三个零件是什么」猜完再揭示主板、屏幕、摄像头的成本占比注意力立刻回来。互动环节设计三个递进问题为什么手机能做薄电池却做不大同样容量的电池为什么有的机器更耐用为什么游戏手机要加均热板而不是加风扇三个问题分别对应结构约束、系统调度、散热路径答不上来正好是讲授缺口。教案文档里还要有四个必备字段教学目标知识、技能、素养各一条、重难点、教具清单机模、螺丝刀、结构图打印件、作业画出自己手机的四层结构。这四个字段是评审和复用时的检查项缺一项这份教案就不算完整。3. 用 python-pptx 生成「手机功能及结构介绍」教案的最小脚本3.1 环境准备与母版版式约定先装依赖再准备模板。模板这一步不能省脚本只负责往版式里灌内容配色、logo、页脚页码交给母版改一次全篇生效。python -m venv .venv # Windows 用 .venv\Scripts\activate source .venv/bin/activate pip install python-pptx pyyaml matplotlib pillow soffice --version # 检查 LibreOffice 是否可用后面导出 PDF 要用母版约定四个版式索引固定0 是封面1 是标题加正文2 是图文左右分栏3 是纯表格页。做法是在 PowerPoint 里打开一份空白模板进「视图 → 幻灯片母版」把不需要的占位符删掉留下标题和正文两个另存为template.pptx。占位符留得越干净脚本里按索引取就越不会错位。注意不要直接在脚本里硬编码字号和颜色。母版里设好主题字体脚本只在需要覆盖时才设置 run 级样式否则后期换主题会非常痛苦。3.2 生成封面与知识点页的核心脚本下面这段是能直接跑的骨架包含中文字体设置、封面生成、要点页生成和讲师备注写入。from pptx import Presentation from pptx.util import Pt from pptx.oxml.ns import qn from lxml import etree def set_cjk_font(run, name微软雅黑, size20, boldFalse): 同时设置西文与东亚字体否则中文会回退成宋体 run.font.name name # 写入 a:latin run.font.size Pt(size) run.font.bold bold rPr run._r.get_or_add_rPr() ea rPr.find(qn(a:ea)) if ea is None: ea etree.SubElement(rPr, qn(a:ea)) latin rPr.find(qn(a:latin)) if latin is not None: latin.addnext(ea) # a:ea 必须排在 a:latin 之后 ea.set(typeface, name) def get_body_placeholder(slide, idx1): 按占位符 idx 取正文框避免跨模板索引错位 for ph in slide.placeholders: if ph.placeholder_format.idx idx and ph.has_text_frame: return ph return None def build_deck(template, out_path, sections): prs Presentation(template) cover prs.slides.add_slide(prs.slide_layouts[0]) cover.placeholders[0].text_frame.text 手机功能及结构介绍 cover.placeholders[1].text_frame.text 45 分钟学习教案 | 讲师待填 for sec in sections: slide prs.slides.add_slide(prs.slide_layouts[1]) slide.placeholders[0].text_frame.text sec[title] body get_body_placeholder(slide) body.text_frame.clear() for i, bullet in enumerate(sec[points]): para body.text_frame.paragraphs[0] if i 0 else body.text_frame.add_paragraph() para.text bullet para.level 0 para.line_spacing Pt(30) # 行距给足投影才不挤 set_cjk_font(para.runs[0], size20 if i 0 else 18) if sec.get(note): slide.notes_slide.notes_text_frame.text sec[note] prs.save(out_path) return out_path SECTIONS [ {title: 第一层外观与防护结构, points: [盖板玻璃 / 中框 / 后盖的三明治结构, 天线缝位置决定信号表现], note: 拿机模让学生指认三个结构件控制在 4 分钟}, {title: 第二层显示与触控层, points: [面板、触控层、盖板的贴合方式, 全贴合与非贴合的厚度与反光差异], note: 重点讲贴合不要展开面板型号}, ] if __name__ __main__: build_deck(template.pptx, dist/手机功能及结构介绍.pptx, SECTIONS)逻辑上分三步先按版式索引建页再灌文本最后写备注。参数上有三处必须留意set_cjk_font里a:ea的插入位置影响 XML 合法性用addnext挂在a:latin后面最稳get_body_placeholder用placeholder_format.idx而不是列表下标换模板时不容易崩line_spacing用Pt而不是倍数跨字号时表现一致。notes_slide是延迟创建的第一次访问时会自动生成备注页所以模板里不需要预留备注版式。备注页里写的就是教案的「讲授提示」导出时不会出现在放映画面上但打印讲义可以带上。3.3 占位符索引与中文字体这两个必踩的坑第一个坑是slide.placeholders[1]报 IndexError。原因是不同版式的占位符数量不一致封面版式可能只有两个图文版式有三个。稳妥做法就是上面那个按 idx 查找的函数并且加空值判断。第二个坑是中文显示成宋体、行距诡异。python-pptx 的font.name只写a:latin东亚字符由a:ea控制不设就会走主题默认值。上面set_cjk_font已经处理注意在 Linux 上跑脚本时字体名要换成服务器实际安装的字体比如「Source Han Sans SC」否则生成的 pptx 在别的机器上会缺字。提示脚本生成后一定用 PowerPoint 或 WPS 打开一次再交付。字体回退和占位符错位这两类问题只在渲染阶段暴露。4. 结构爆炸图与参数对比表怎么放进 pptx4.1 用 matplotlib 画分层结构图并插入结构图不要从网上找版权和清晰度都不可控。用 matplotlib 画四层堆叠图输出透明底 PNG插进幻灯片后可以和主题色保持一致。import matplotlib matplotlib.use(Agg) import matplotlib.pyplot as plt from matplotlib.patches import FancyBboxPatch, FancyArrowPatch plt.rcParams[font.sans-serif] [Microsoft YaHei, Source Han Sans SC] plt.rcParams[axes.unicode_minus] False layers [ 盖板玻璃 触控层, OLED 显示面板, 中框 主板SoC / 射频 / 电源, 电池 VC 均热板 马达, ] fig, ax plt.subplots(figsize(5, 4.2), dpi200) for i, name in enumerate(layers): y 3 - i ax.add_patch(FancyBboxPatch((0.06, y 0.10), 0.88, 0.72, boxstyleround,pad0.02, linewidth1.2, edgecolor#2b6cb0, facecolor#ebf4ff)) ax.text(0.5, y 0.46, name, hacenter, vacenter, fontsize11) # 标注装配方向帮助学生理解拆机顺序 ax.add_patch(FancyArrowPatch((1.02, 3.8), (1.02, 0.2), arrowstyle-|, mutation_scale14, color#718096)) ax.text(1.06, 2.0, 拆机方向, rotation270, vacenter, fontsize9, color#718096) ax.set_xlim(0, 1.25) ax.set_ylim(0, 4) ax.axis(off) fig.savefig(phone_layers.png, bbox_inchestight, transparentTrue)dpi200是投影和打印的平衡点再高只会让 pptx 体积翻倍。transparentTrue让图片背景跟着母版底色走避免白底贴在有底色版式上出现色块。字体列表按顺序回退Windows 命中雅黑Linux 命中思源黑体。插入时用宽度约束而不是高度这样换版式时图片不会溢出边界from pptx.util import Inches slide.shapes.add_picture(phone_layers.png, Inches(6.0), Inches(1.6), widthInches(4.0))4.2 参数对比表用原生表格别截图参数页SoC、屏幕、电池、摄像头每学期都要改一旦截图就变成手工活。用 pptx 原生表格数据改一行重跑一次脚本即可。from pptx.util import Inches, Pt from pptx.dml.color import RGBColor def add_spec_table(slide, rows, leftInches(0.8), topInches(1.8), widthInches(8.4), heightInches(3.6), font_size14): shape slide.shapes.add_table(len(rows), len(rows[0]), left, top, width, height) table shape.table table.columns[0].width Inches(2.0) # 第一列放功能名窄一点 for r, row in enumerate(rows): for c, text in enumerate(row): cell table.cell(r, c) cell.text str(text) cell.margin_top cell.margin_bottom Pt(4) para cell.text_frame.paragraphs[0] set_cjk_font(para.runs[0], sizefont_size, bold(r 0)) if r 0: cell.fill.solid() cell.fill.fore_color.rgb RGBColor(0x2B, 0x6C, 0xB0) para.runs[0].font.color.rgb RGBColor(0xFF, 0xFF, 0xFF) return table关键参数是列宽和字号。第一列给 2 英寸装功能名剩下 6.4 英寸平铺三列参数14pt 在教室投影的后排也能看清。表头深底白字是硬性要求浅色底加黑字在亮度不足的投影仪上几乎糊成一片。注意表格行高在 python-pptx 里是「最小高度」内容多了会自动撑开。行数超过 8 行就拆成两页别指望缩字号解决。4.3 导出 PDF 与把 pptx 体积压到 15MB 以内教案要发给学生PDF 比 pptx 靠谱得多不会因字体缺失变形。用 LibreOffice 无头模式转换soffice --headless --convert-to pdf --outdir dist dist/手机功能及结构介绍.pptx ls -lh dist/*.pdf体积控制优先从源头做插图片前先用 Pillow 压一道from PIL import Image img Image.open(phone_layers.png).convert(RGBA) img.thumbnail((1600, 1600), Image.LANCZOS) img.save(phone_layers_opt.png, optimizeTrue)长边控制在 1600 像素一页配图通常在 200KB 上下一整套 30 页的教案连图带表能压在 10MB 以内。如果还是超标检查是不是误插了相机原图或带图层的 PSD 导出图这类文件单张就能到 8MB。5. 教案模板化与生成后校验5.1 把教案正文抽成 YAML脚本只做渲染到了要复用的阶段内容就不该留在 Python 文件里。抽成 YAML 之后改文案的人和改代码的人可以分开也能进版本管理看 diff。# lesson.yaml —— 手机结构教案的唯一数据源 meta: title: 手机功能及结构介绍 duration: 45 speaker: 张工 sections: - layout: 1 title: 第一层外观与防护结构 points: - 盖板玻璃 / 中框 / 后盖的三明治结构 - 天线缝位置决定信号表现 note: 拿机模让学生指认三个结构件控制在 4 分钟 - layout: 3 title: 主流机型参数对比 table: - [功能, 结构件, 演示点] - [续航, 电芯 充电 IC, 充电曲线差异] - [散热, VC 均热板 中框, 温度墙与降频]渲染时按layout字段分派1 走要点页3 走表格页2 走图文分栏页。这样加一节内容只改 YAML脚本一行不动。5.2 生成后跑一次三项自动校验人眼翻 30 页一定漏脚本扫一遍更省事。三项检查分别是页数、空占位符、文字溢出估算。from pptx import Presentation def audit(path, expected_slides): prs Presentation(path) report [] if len(prs.slides) ! expected_slides: report.append(f页数不符期望 {expected_slides}实际 {len(prs.slides)}) for i, slide in enumerate(prs.slides, 1): for ph in slide.placeholders: if not ph.has_text_frame: continue tf ph.text_frame if not tf.text.strip(): report.append(f第 {i} 页占位符 idx{ph.placeholder_format.idx} 为空) continue size max((r.font.size.pt for p in tf.paragraphs for r in p.runs if r.font.size), default18) width_pt, height_pt ph.width / 12700, ph.height / 12700 per_line max(int(width_pt / size), 1) lines sum(max(1, -(-len(p.text) // per_line)) for p in tf.paragraphs) if lines * size * 1.4 height_pt: report.append(f第 {i} 页可能溢出需 {lines} 行可用 {height_pt:.0f}pt) return report or [校验通过] if __name__ __main__: for line in audit(dist/手机功能及结构介绍.pptx, expected_slides12): print(line)12700 是 1pt 对应的 EMU 数用它把占位符尺寸换算成排版单位。溢出估算按「每行宽度除以字号」算汉字容量再乘 1.4 倍行高系数比实际略保守正好留出安全余量。5.3 讲师版与学员版用备注页和母版一次分发最后一步是分发。讲师版保留备注页导出时勾选「打印备注」学员版直接从母版里把备注页版式删掉再导一次 PDF。两个版本共用同一份 YAML只是build_deck时传一个with_notes开关控制是否写入notes_slide。页码和页脚统一走母版占位符不要在脚本里逐页画文本框——一旦某页版式不同页码就会跳位。改完母版记得全篇预览一次重点看表格页和图文页的页脚位置是否一致这两类版式最容易漏改。本文还有配套的精品资源点击获取 手机功能与结构介绍PPT学习教案：python-pptx自动化生成
简介这是一份面向通信、电子及计算机相关专业学习者与初学者的手机结构认知课件围绕手机外部按键接口、内部组件与核心硬件逐层展开可用于课堂教学、自学入门或硬件拆解前的知识铺垫。压缩包内共1个pptx文件约2.38MB以图文幻灯片形式呈现配合12页内容按模块讲解便于直接投影讲授或课后翻阅。课件从听筒、触摸键、MIC、音量键、充电/UsB接口、前后摄像头、扬声器、耳机接口、开机键、SIM卡槽与内存卡槽等外部结构讲起再延伸至LCD/TPLCD、前壳后壳与电池盖、电池、主板副板、距离感应器等内部组件并进一步介绍高通MSM8225处理器、Hynix海力士内存以及电源管理芯片、功率放大器、射频收发器等关键电子元件形成由外到内、由整机到元件的完整知识链条。目前已有124人学习适合需要快速建立手机软硬件整体认知、或为维修与电子技术课程做预习复习的读者参考。1. 一份手机功能及结构介绍PPT学习教案卡住人的往往不是知识点职校硬件基础课、售后工程师新人培训、拆解类公开课撞上的其实是同一件事手机功能与手机结构这些知识点本身不难难的是每学期都要重做一份能直接上课的 pptx。参数年年小改结构图年年要换成可编辑版本讲师备注还得跟 45 分钟课时严丝合缝最后往往变成「上课前一周熬夜贴图」。这份学习教案要解决的核心问题很具体把「手机由哪些结构件组成、每类结构件支撑什么用户功能、这些内容怎么在 45 分钟里讲完」变成一套结构固定、数据外置、能用脚本重新生成的课件。适合三类人要反复开这门课的讲师、给新人做硬件科普的测试与售后工程师、以及想用 python-pptx 把课件自动化的开发者。教案不是知识堆砌它是一个可复用、可校验、可版本管理的工程产物。2. 手机功能与结构知识点怎么拆进 45 分钟教案2.1 结构按「外到内四层」拆而不是按零件罗列初学者最容易被一串零件名劝退中框、后盖、盖板玻璃、FPC、屏蔽罩、均热板、线性马达。按零件讲学生记不住按层讲学生能自己推导。我一般会切成四层教学顺序就是拆机顺序也是用户认知顺序。第一层是外观与防护层包含盖板玻璃、中框、后盖。这一层决定了握持手感、重量分配、天线缝位置也是「为什么金属后盖会挡信号」这个经典问题的答案所在。第二层是显示与触控层包含 OLED 或 LCD 面板、触控感应层、偏光片与贴合胶。教学重点是「面板、触控、盖板三者贴合方式」——全贴合与非全贴合的差异会直接体现在厚度、进灰和反光上学生一摸真机就有感觉。第三层是主板与计算层包含 SoC、内存与闪存、射频前端、电源管理 IC、摄像头接口。这一层信息密度最高建议只讲清「哪些功能由哪块芯片负责」不要陷进制程和型号对比。第四层是能源、散热与声学层包含电芯、充电 IC、VC 均热板或石墨片、扬声器、马达。这一层是「性能释放」话题的落点跑分高不高看 SoC跑得久不久看散热和电池。四层拆完再回头讲整机装配顺序学生基本能把拆机视频看懂。这个顺序也方便做板书PPT 一页放一层翻页节奏和讲授节奏天然对齐。2.2 手机功能与结构件的对应关系表教案里最值钱的一页是「功能—结构件」映射表它把用户语言翻译成硬件语言。下表可以直接抄进 PPT也可以作为 YAML 数据源里的一张 section。用户可见功能主要结构件课堂演示点通信与上网射频前端、中框天线缝、天线调谐器握持姿势如何影响信号强度拍照与录像摄像头模组、ISP、OIS 马达像素数不等于画质传感器尺寸更关键续航与快充电芯、充电 IC、Type-C 接口双电芯串联与单电芯的充电曲线差异触控与交互触控层、线性马达、扬声器触觉反馈延迟与触控采样率的关系感知能力加速度计、陀螺仪、光线与霍尔传感器传感器融合为什么需要校准散热表现VC 均热板、石墨片、中框导热路径温度墙触发后频率如何回落表格的讲法有讲究。不要一页念完挑三行展开通信对应天线缝、拍照对应 OIS、续航对应电芯结构。剩下三行留作课后阅读教案里标注「自学页」学生带着问题看反而记得牢。2.3 45 分钟课时分配与提问设计课时分配不写进 PPT但必须写进教案文档否则讲起来一定前松后紧。常用节奏是导入 5 分钟结构四层 18 分钟功能映射 12 分钟互动与答疑 8 分钟作业布置 2 分钟。导入环节别用「今天我们来学习手机结构」这种开场。拿一台退役机模让学生先猜「这台机器最贵的三个零件是什么」猜完再揭示主板、屏幕、摄像头的成本占比注意力立刻回来。互动环节设计三个递进问题为什么手机能做薄电池却做不大同样容量的电池为什么有的机器更耐用为什么游戏手机要加均热板而不是加风扇三个问题分别对应结构约束、系统调度、散热路径答不上来正好是讲授缺口。教案文档里还要有四个必备字段教学目标知识、技能、素养各一条、重难点、教具清单机模、螺丝刀、结构图打印件、作业画出自己手机的四层结构。这四个字段是评审和复用时的检查项缺一项这份教案就不算完整。3. 用 python-pptx 生成「手机功能及结构介绍」教案的最小脚本3.1 环境准备与母版版式约定先装依赖再准备模板。模板这一步不能省脚本只负责往版式里灌内容配色、logo、页脚页码交给母版改一次全篇生效。python -m venv .venv # Windows 用 .venv\Scripts\activate source .venv/bin/activate pip install python-pptx pyyaml matplotlib pillow soffice --version # 检查 LibreOffice 是否可用后面导出 PDF 要用母版约定四个版式索引固定0 是封面1 是标题加正文2 是图文左右分栏3 是纯表格页。做法是在 PowerPoint 里打开一份空白模板进「视图 → 幻灯片母版」把不需要的占位符删掉留下标题和正文两个另存为template.pptx。占位符留得越干净脚本里按索引取就越不会错位。注意不要直接在脚本里硬编码字号和颜色。母版里设好主题字体脚本只在需要覆盖时才设置 run 级样式否则后期换主题会非常痛苦。3.2 生成封面与知识点页的核心脚本下面这段是能直接跑的骨架包含中文字体设置、封面生成、要点页生成和讲师备注写入。from pptx import Presentation from pptx.util import Pt from pptx.oxml.ns import qn from lxml import etree def set_cjk_font(run, name微软雅黑, size20, boldFalse): 同时设置西文与东亚字体否则中文会回退成宋体 run.font.name name # 写入 a:latin run.font.size Pt(size) run.font.bold bold rPr run._r.get_or_add_rPr() ea rPr.find(qn(a:ea)) if ea is None: ea etree.SubElement(rPr, qn(a:ea)) latin rPr.find(qn(a:latin)) if latin is not None: latin.addnext(ea) # a:ea 必须排在 a:latin 之后 ea.set(typeface, name) def get_body_placeholder(slide, idx1): 按占位符 idx 取正文框避免跨模板索引错位 for ph in slide.placeholders: if ph.placeholder_format.idx idx and ph.has_text_frame: return ph return None def build_deck(template, out_path, sections): prs Presentation(template) cover prs.slides.add_slide(prs.slide_layouts[0]) cover.placeholders[0].text_frame.text 手机功能及结构介绍 cover.placeholders[1].text_frame.text 45 分钟学习教案 | 讲师待填 for sec in sections: slide prs.slides.add_slide(prs.slide_layouts[1]) slide.placeholders[0].text_frame.text sec[title] body get_body_placeholder(slide) body.text_frame.clear() for i, bullet in enumerate(sec[points]): para body.text_frame.paragraphs[0] if i 0 else body.text_frame.add_paragraph() para.text bullet para.level 0 para.line_spacing Pt(30) # 行距给足投影才不挤 set_cjk_font(para.runs[0], size20 if i 0 else 18) if sec.get(note): slide.notes_slide.notes_text_frame.text sec[note] prs.save(out_path) return out_path SECTIONS [ {title: 第一层外观与防护结构, points: [盖板玻璃 / 中框 / 后盖的三明治结构, 天线缝位置决定信号表现], note: 拿机模让学生指认三个结构件控制在 4 分钟}, {title: 第二层显示与触控层, points: [面板、触控层、盖板的贴合方式, 全贴合与非贴合的厚度与反光差异], note: 重点讲贴合不要展开面板型号}, ] if __name__ __main__: build_deck(template.pptx, dist/手机功能及结构介绍.pptx, SECTIONS)逻辑上分三步先按版式索引建页再灌文本最后写备注。参数上有三处必须留意set_cjk_font里a:ea的插入位置影响 XML 合法性用addnext挂在a:latin后面最稳get_body_placeholder用placeholder_format.idx而不是列表下标换模板时不容易崩line_spacing用Pt而不是倍数跨字号时表现一致。notes_slide是延迟创建的第一次访问时会自动生成备注页所以模板里不需要预留备注版式。备注页里写的就是教案的「讲授提示」导出时不会出现在放映画面上但打印讲义可以带上。3.3 占位符索引与中文字体这两个必踩的坑第一个坑是slide.placeholders[1]报 IndexError。原因是不同版式的占位符数量不一致封面版式可能只有两个图文版式有三个。稳妥做法就是上面那个按 idx 查找的函数并且加空值判断。第二个坑是中文显示成宋体、行距诡异。python-pptx 的font.name只写a:latin东亚字符由a:ea控制不设就会走主题默认值。上面set_cjk_font已经处理注意在 Linux 上跑脚本时字体名要换成服务器实际安装的字体比如「Source Han Sans SC」否则生成的 pptx 在别的机器上会缺字。提示脚本生成后一定用 PowerPoint 或 WPS 打开一次再交付。字体回退和占位符错位这两类问题只在渲染阶段暴露。4. 结构爆炸图与参数对比表怎么放进 pptx4.1 用 matplotlib 画分层结构图并插入结构图不要从网上找版权和清晰度都不可控。用 matplotlib 画四层堆叠图输出透明底 PNG插进幻灯片后可以和主题色保持一致。import matplotlib matplotlib.use(Agg) import matplotlib.pyplot as plt from matplotlib.patches import FancyBboxPatch, FancyArrowPatch plt.rcParams[font.sans-serif] [Microsoft YaHei, Source Han Sans SC] plt.rcParams[axes.unicode_minus] False layers [ 盖板玻璃 触控层, OLED 显示面板, 中框 主板SoC / 射频 / 电源, 电池 VC 均热板 马达, ] fig, ax plt.subplots(figsize(5, 4.2), dpi200) for i, name in enumerate(layers): y 3 - i ax.add_patch(FancyBboxPatch((0.06, y 0.10), 0.88, 0.72, boxstyleround,pad0.02, linewidth1.2, edgecolor#2b6cb0, facecolor#ebf4ff)) ax.text(0.5, y 0.46, name, hacenter, vacenter, fontsize11) # 标注装配方向帮助学生理解拆机顺序 ax.add_patch(FancyArrowPatch((1.02, 3.8), (1.02, 0.2), arrowstyle-|, mutation_scale14, color#718096)) ax.text(1.06, 2.0, 拆机方向, rotation270, vacenter, fontsize9, color#718096) ax.set_xlim(0, 1.25) ax.set_ylim(0, 4) ax.axis(off) fig.savefig(phone_layers.png, bbox_inchestight, transparentTrue)dpi200是投影和打印的平衡点再高只会让 pptx 体积翻倍。transparentTrue让图片背景跟着母版底色走避免白底贴在有底色版式上出现色块。字体列表按顺序回退Windows 命中雅黑Linux 命中思源黑体。插入时用宽度约束而不是高度这样换版式时图片不会溢出边界from pptx.util import Inches slide.shapes.add_picture(phone_layers.png, Inches(6.0), Inches(1.6), widthInches(4.0))4.2 参数对比表用原生表格别截图参数页SoC、屏幕、电池、摄像头每学期都要改一旦截图就变成手工活。用 pptx 原生表格数据改一行重跑一次脚本即可。from pptx.util import Inches, Pt from pptx.dml.color import RGBColor def add_spec_table(slide, rows, leftInches(0.8), topInches(1.8), widthInches(8.4), heightInches(3.6), font_size14): shape slide.shapes.add_table(len(rows), len(rows[0]), left, top, width, height) table shape.table table.columns[0].width Inches(2.0) # 第一列放功能名窄一点 for r, row in enumerate(rows): for c, text in enumerate(row): cell table.cell(r, c) cell.text str(text) cell.margin_top cell.margin_bottom Pt(4) para cell.text_frame.paragraphs[0] set_cjk_font(para.runs[0], sizefont_size, bold(r 0)) if r 0: cell.fill.solid() cell.fill.fore_color.rgb RGBColor(0x2B, 0x6C, 0xB0) para.runs[0].font.color.rgb RGBColor(0xFF, 0xFF, 0xFF) return table关键参数是列宽和字号。第一列给 2 英寸装功能名剩下 6.4 英寸平铺三列参数14pt 在教室投影的后排也能看清。表头深底白字是硬性要求浅色底加黑字在亮度不足的投影仪上几乎糊成一片。注意表格行高在 python-pptx 里是「最小高度」内容多了会自动撑开。行数超过 8 行就拆成两页别指望缩字号解决。4.3 导出 PDF 与把 pptx 体积压到 15MB 以内教案要发给学生PDF 比 pptx 靠谱得多不会因字体缺失变形。用 LibreOffice 无头模式转换soffice --headless --convert-to pdf --outdir dist dist/手机功能及结构介绍.pptx ls -lh dist/*.pdf体积控制优先从源头做插图片前先用 Pillow 压一道from PIL import Image img Image.open(phone_layers.png).convert(RGBA) img.thumbnail((1600, 1600), Image.LANCZOS) img.save(phone_layers_opt.png, optimizeTrue)长边控制在 1600 像素一页配图通常在 200KB 上下一整套 30 页的教案连图带表能压在 10MB 以内。如果还是超标检查是不是误插了相机原图或带图层的 PSD 导出图这类文件单张就能到 8MB。5. 教案模板化与生成后校验5.1 把教案正文抽成 YAML脚本只做渲染到了要复用的阶段内容就不该留在 Python 文件里。抽成 YAML 之后改文案的人和改代码的人可以分开也能进版本管理看 diff。# lesson.yaml —— 手机结构教案的唯一数据源 meta: title: 手机功能及结构介绍 duration: 45 speaker: 张工 sections: - layout: 1 title: 第一层外观与防护结构 points: - 盖板玻璃 / 中框 / 后盖的三明治结构 - 天线缝位置决定信号表现 note: 拿机模让学生指认三个结构件控制在 4 分钟 - layout: 3 title: 主流机型参数对比 table: - [功能, 结构件, 演示点] - [续航, 电芯 充电 IC, 充电曲线差异] - [散热, VC 均热板 中框, 温度墙与降频]渲染时按layout字段分派1 走要点页3 走表格页2 走图文分栏页。这样加一节内容只改 YAML脚本一行不动。5.2 生成后跑一次三项自动校验人眼翻 30 页一定漏脚本扫一遍更省事。三项检查分别是页数、空占位符、文字溢出估算。from pptx import Presentation def audit(path, expected_slides): prs Presentation(path) report [] if len(prs.slides) ! expected_slides: report.append(f页数不符期望 {expected_slides}实际 {len(prs.slides)}) for i, slide in enumerate(prs.slides, 1): for ph in slide.placeholders: if not ph.has_text_frame: continue tf ph.text_frame if not tf.text.strip(): report.append(f第 {i} 页占位符 idx{ph.placeholder_format.idx} 为空) continue size max((r.font.size.pt for p in tf.paragraphs for r in p.runs if r.font.size), default18) width_pt, height_pt ph.width / 12700, ph.height / 12700 per_line max(int(width_pt / size), 1) lines sum(max(1, -(-len(p.text) // per_line)) for p in tf.paragraphs) if lines * size * 1.4 height_pt: report.append(f第 {i} 页可能溢出需 {lines} 行可用 {height_pt:.0f}pt) return report or [校验通过] if __name__ __main__: for line in audit(dist/手机功能及结构介绍.pptx, expected_slides12): print(line)12700 是 1pt 对应的 EMU 数用它把占位符尺寸换算成排版单位。溢出估算按「每行宽度除以字号」算汉字容量再乘 1.4 倍行高系数比实际略保守正好留出安全余量。5.3 讲师版与学员版用备注页和母版一次分发最后一步是分发。讲师版保留备注页导出时勾选「打印备注」学员版直接从母版里把备注页版式删掉再导一次 PDF。两个版本共用同一份 YAML只是build_deck时传一个with_notes开关控制是否写入notes_slide。页码和页脚统一走母版占位符不要在脚本里逐页画文本框——一旦某页版式不同页码就会跳位。改完母版记得全篇预览一次重点看表格页和图文页的页脚位置是否一致这两类版式最容易漏改。本文还有配套的精品资源点击获取