[此处插入封面图 - 建议尺寸 900×1267px]
用 Python 自动生成 PPT，我踩过的坑
从环境安装到风格统一，一篇文章帮你少走弯路
最近为了补充一个工程汇报 PPT，我尝试用 Python 自动生成新增章节。原本以为只是复制代码、运行一下，结果真正操作后才发现，从环境安装、文件路径，到 PPT 风格统一，每一步都可能踩坑。
这篇文章做一个简要复盘，也给想用 Python 批量生成 PPT 的朋友提个醒。
💡 Python 生成 PPT 不难，难的是生成后能不能真正用于汇报。
一、为什么要用 Python 生成 PPT？
这次不是从零做一个全新的 PPT，而是在原有工程汇报文件后面追加内容，比如施工过程控制、质量安全控制、异常工况处置、监测报警流程等。
这些页面结构相似，如果手工一页一页做，不仅费时间，还容易格式不统一。因此我选择使用 python-pptx 批量生成。
✅ python-pptx 能做的事
• 批量生成页面
• 自动写入标题和正文
• 批量生成表格
• 统一设置图片占位
• 在原 PPT 后追加新章节
二、踩过的几个坑
❌ 坑1：文件没有真正保存成 .py
第一个坑是代码文件后缀。Windows 很容易把 Python 文件保存成 make_ppt.py.txt，看起来像 Python 文件，实际上还是普通文本文件。
建议打开文件夹中的"文件扩展名"显示，确认文件后缀真的是 .py。
✅ 正确文件名：make_ppt.py
❌ 错误文件名：make_ppt.py.txt
❌ 坑2：命令行所在文件夹不对
很多时候代码没有运行成功，不是代码错了，而是命令行当前目录不对。比如文件在下载文件夹，但 PowerShell 还停留在 C:\Users\Think。
运行前最好先用 dir 看一下当前目录里有没有代码文件。
如果要打开当前文件夹，可以输入：
❌ 坑3：PPT 生成了，但找不到
有时运行没有报错，却看不到 PPT。后来发现，一种情况是生成到了当前目录，另一种情况是中文文件名乱码，导致不容易识别。
所以建议输出文件名先用英文。
OUTPUT_FILE = "output.pptx"
❌ 坑4：Python 或依赖库没装好
运行代码前，先确认 Python 是否安装成功。
如果提示缺少 pptx 模块，需要安装 python-pptx。
py -m pip install python-pptx
❌ 坑5：PPT 能生成，但风格不统一
这是最核心的问题。最开始生成的新 PPT 是现代风格，而原 PPT 是典型工程汇报风格：4:3 页面、顶部章节标题、红色横线、右上角 logo、正文偏宋体。
如果直接新建空白 PPT，新增页面和原文件很难统一。更好的做法是直接读取原 PPT 作为模板。
prs = Presentation("template.pptx")
这样可以在原 PPT 后面追加页面，并尽量保持页面比例、主题和整体风格。
三、最终采用的解决方案
最后比较稳定的做法是：把原 PPT 复制一份，命名为 template.pptx，再让 Python 在这个模板后面追加页面。这样既不会破坏原文件，又能让新增页面尽量贴近原 PPT 风格。
📁 推荐文件结构
PPT生成文件夹 /
├─ template.pptx
├─ make_ppt.py
├─ ucd_logo.png
└─ output.pptx
py .\make_ppt.py
start .\output.pptx
💡 如果原 PPT 是 4:3，就不要在代码里强行设置成 16:9，否则新增页一定不协调。风格统一的第一步，是页面比例统一。
四、我的避坑清单
📄 文件方面
• 确认 Python 文件后缀是 .py
• 不要保存成 .py.txt
• 代码文件和模板 PPT 放在同一个文件夹
• 输出文件名建议先用英文，例如 output.pptx
🔧 环境方面
• 用 py --version 检查 Python
• 用 py -m pip install python-pptx 安装依赖
• 运行前先做一个最小测试
💻 命令行方面
• 用 dir 检查当前目录
• 用 explorer . 打开当前文件夹
• 用 dir *.pptx 查看是否生成 PPT
🎨 PPT 风格方面
• 优先使用原 PPT 作为模板
• 保持页面比例一致
• 统一字体、标题、颜色和 logo
• 自动生成后仍需人工精修
五、最后的体会
这次最大的感受是：Python 自动生成 PPT 的难点，不是能不能生成，而是生成后能不能真正融入原来的 PPT。
python-pptx 很适合处理重复页面，比如批量标题、正文、表格和图片占位。但如果要用于正式汇报，最后仍然需要人工检查和调整。
如果以后再做类似任务，我会按这个流程来：先准备模板，再做最小测试，然后批量生成，最后人工精修。这样比一开始就跑完整大代码更稳。
准备模板 → 最小测试 → 批量生成 → 人工精修 → 最终检查
✅ 记住三句话：文件名先用英文，运行前确认当前目录，一定要用原 PPT 作为模板。
附：常用命令
py --version # 查看 Python 版本 py -m pip install python-pptx # 安装 PPT 库 dir # 查看当前文件夹 explorer . # 打开当前文件夹 py .\make_ppt.py # 运行代码 dir *.pptx # 查看生成的 PPT start .\output.pptx # 打开生成的 PPT
希望这篇简短复盘，能帮准备使用 Python 自动生成 PPT 的朋友少踩几个坑。
