PHPWord 原生不支持直接解析 HTML 标签（如 ），若将含 HTML 的字符串传入 addText() 会导致内容无法渲染或文档为空；需通过 HTML 解析器预处理，或改用 addHtml() 方法（PHPWord ≥ 0.18.0）实现富文本导入。
phpword 原生不支持直接解析 html 标签（如 `
`），若将含 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>, <ol>, <li>, <br> 等）
$section->addHtml('<p><b>Hello</b>, <i>world</i>!</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill4683" title="Cn Password Generator"><img
src="https://img.php.cn/upload/skill/000/000/081/179015770394083.jpg" alt="Cn Password Generator" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill4683" title="Cn Password Generator">Cn Password Generator</a>
<p>安全的随机密码生成器。支持自定义长度、字符类型（大写/小写字母、数字、特殊符号），排除相似字符，批量生成。纯 Python 标准库，无需 API 密钥。</p>
</div>
<a href="/xiazai/skill4683" title="Cn Password Generator" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>This is a second paragraph.</p><p><span>立即学习</span>“<a href="https://pan.quark.cn/s/7fc7563c4182" style="text-decoration: underline !important; color: blue; font-weight: bolder;" rel="nofollow" target="_blank">PHP免费学习笔记（深入）</a>”；</p>');
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');
$objWriter->save('output.docx');⚠️ 注意事项：
-
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 对象模型。
