PHPWord 原生不支持直接解析 HTML 标签（如 ），若将含 HTML 的字符串传入 addText() 会导致内容无法渲染或文档为空；需通过 HTML 解析器预处理，或改用 addHtml() 方法（PHPWord ≥ 0.18.0）实现富文本导入。
`），若将含 HTML 的字符串传入 `addText()` 会导致内容无法渲染或文档为空；需通过 HTML 解析器预处理，或改用 `addHtml()` 方法（PHPWord ≥ 0.18.0）实现富文本导入。
PHPWord 是一个功能强大的 PHP Office 文档生成库，但其 addText() 方法仅接受纯文本或简单内联样式（如加粗、颜色），不解析 HTML 标签。当你传入 '<p>test</p>' 时，PHPWord 将其视为普通字符串字面量，而非语义化段落结构——Word 引擎无法识别该标签，最终可能因格式异常而跳过渲染，导致 DOCX 文件内容为空。
✅ 正确做法：使用 addHtml() 方法（推荐，适用于 PHPWord v0.18.0+）
use PhpOffice\PhpWord\PhpWord;
$phpWord = new PhpWord();
$section = $phpWord->addSection();
// ✅ 支持基础 HTML 标签（<p>, <b>, <i>, <ul>, </ul>
<ol>, <li>, <br> 等）
$section->addHtml('<p><b>Hello</b>, <i>world</i>!</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5117" title="HTML Extract"><img
src="https://img.php.cn/upload/skill/000/000/081/179033952939354.jpg" alt="HTML Extract" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill5117" title="HTML Extract" class="overflowclass">HTML Extract</a>
<p class="overflowclass">使用 MinerU 从 HTML 页面和文件中提取内容，将 HTML 转换为保持标题、列表、表格及文本层次结构的干净、结构化 Markdown。F...</p>
</div>
<a rel="nofollow" href="/xiazai/skill5117" title="HTML Extract" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<p>This is a second paragraph.</p>');
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');
$objWriter->save('output.docx');</li>
</ol></i></b></p>
⚠️ 注意事项：
-
addHtml()不支持复杂 HTML（如<div style="...">、CSS 类、JavaScript 或嵌套表格），仅解析语义化块级/行内标签；<li>若使用旧版 PHPWord（DOMDocument + <code>strip_tags()提取纯文本，或集成第三方库如html2text）； - 避免在
addText()中传入任何 HTML 字符串——即使仅含<br>，也应改用$section->addText('line1')->addText('line2')或addHtml("line1<br>line2")； - 导出前建议检查
$section->getElements()是否非空，便于快速定位渲染失败问题。
? 总结：HTML ≠ Word 兼容格式。始终优先选用 addHtml() 处理简单富文本；对复杂页面结构，建议先用 HTML 转 Word 专用服务（如 Pandoc、DocxGenJS 后端封装），或分段构建 PHPWord 对象模型。
