能落地的PPT生成方案只有三类：前端用pptxgenjs（需手动解析HTML、设中文字体）、服务端用python-pptx+BeautifulSoup（需解析HTML并分发标签、注意字体和路径）、PDF中转（仅适合交付，内容不可编辑）。
没有“一键导出”的通用方案，能落地的只有三类路径：前端纯浏览器生成（适合单页报告）、服务端批量处理（适合定时任务）、PDF中转（适合快速应急）。
用 pptxgenjs 在浏览器里生成 PPT（适合单页 HTML 报告）
这是唯一真正“不走服务器、不传文件、不调 API”的纯前端方案，但必须手动解析 HTML 结构，不能直接扔一个 <div> 进去就出幻灯片。
- 常见错误：
Cannot read property 'addSlide' of undefined—— 多半是漏了new pptxgen()，写了pptxgen.addSlide()这种静态调用 - 图片必须是跨域可读 URL 或 base64；
<img src="chart.png">这种相对路径会静默失败，得提前补全为绝对地址或转成 base64 -
<table>、<pre>、带内联样式的嵌套<div>都不会自动渲染，得自己遍历 DOM 提取文本/单元格/代码行，再调slide.addText()或slide.addTable() - 中文需显式设字体：比如
textOpts.fontFace = "Microsoft YaHei"，否则默认是 Arial，Windows/macOS 一般有，Linux 服务器环境大概率缺字
用 python-pptx + BeautifulSoup 做服务端批量生成（适合日报/测试报告）
如果你有后端、要跑 cron、或者 HTML 来自模板渲染（如 Jinja2 + Markdown），这条路更稳，也更容易控制每张幻灯片的版式和字体。
- python-pptx 不认 HTML 字符串，必须先用
BeautifulSoup(html_str, "html.parser")解析，再按标签分发：比如<h1>→slide.shapes.title.text，<p>→ 新建textbox再赋值 - 表格行数超 20 行容易卡死或 OOM，建议拆成多个 slide，用
prs.slides.add_slide(prs.slide_layouts[1])换成“标题+内容”布局 - 保存路径别写
/tmp/report.pptx或网络挂载路径，容器或 CI 环境常因权限/挂载点不可写导致prs.save()静默失败，优先写到当前工作目录并检查返回值 - 中文乱码不是编码问题，是字体缺失：得对每个
run显式设run.font.name = "Microsoft YaHei"，且确保系统已安装该字体（Ubuntu 可装fonts-wqy-zenhei作 fallback）
用 PowerPoint 自带打开功能或 PDF 中转（适合临时救急）
PowerPoint 本身支持直接打开 .html 文件，本质是调用 IE/Edge 引擎做一次“网页快照”，它不解析 HTML，只渲染可视 DOM —— 所以 JS 渲染的内容、display: none 元素、动态加载的图表都可能丢失或错位。
立即学习“前端免费学习笔记（深入）”；
- 在 PowerPoint 中点击“文件 → 打开”，类型选“所有文件”，找到你的
report.html即可加载 - 如果页面含大量交互或 Canvas 图表，先用浏览器“打印 → 另存为 PDF”，再用 WPS 或新版 PowerPoint 的“插入 → PDF”功能导入，PDF 页面会自动映射为幻灯片
- 此法生成的 PPT 是“图像化”的：文字不可编辑、图表无法重配色、表格无法增删行列 —— 仅适合最终交付，不适合后续修改
最容易被忽略的一点：无论哪种路径，HTML 中的图片路径、CSS 类名、JS 动态插入的节点，都不会自动适配 PPT 的渲染逻辑。你得决定哪些内容“值得保留”，哪些“宁可丢弃也要保证结构清晰”。这不是格式转换，是内容重构。
