使用TCPDF将HTML转PDF后样式错乱问题及替代方案咨询

问题原因排查 #

• TCPDF对CSS的支持度非常有限，你代码中用到的:nth-child伪类、!important规则、border-spacing、text-transform的部分场景、以及精细的margin/padding百分比控制都不在TCPDF的支持范围内，样式直接失效是布局错乱的核心原因。
• 你HTML中引入的Google Fonts远程字体无法被TCPDF加载，同时TCPDF初始化时强制指定了默认的dejavusans字体，导致你CSS中设置的Fira Sans字体完全不生效，字体大小、行高也会出现偏差。
• TCPDF的表格宽度计算逻辑和浏览器内核差异极大，你给嵌套表格、表格列设置的百分比宽度无法被正确解析，就会出现列宽错乱、内容溢出的问题。
• TCPDF不支持外部样式表加载，你写在head中的样式只有非常基础的部分能被识别，大多数规则都会被忽略。

适配方案（保留TCPDF的前提下） #

• 删掉所有:nth-child、!important这类不支持的CSS规则，所有样式都直接写在对应标签的style属性中，每一列的宽度、对齐方式、内边距都显式声明。
• 手动将Fira Sans字体导入TCPDF的字体库，调用AddFont()方法加载自定义字体，不要使用远程字体链接。
• 所有表格的总宽度、每一列的宽度都写死固定值，不要依赖自动百分比计算。

效果更好的HTML转PDF工具推荐 #

• mPDF：PHP生态下的PDF生成库，对CSS的支持度远高于TCPDF，支持绝大多数CSS2.1和部分CSS3特性，自定义字体、表格布局、样式选择器的适配都做的更好，和现有PHP项目集成成本低，非常适合生成发票这类结构化文档。
• WKHTMLTOPDF：基于Webkit内核的开源转换工具，渲染效果和Chrome浏览器几乎完全一致，支持所有现代CSS特性，PHP端可以通过第三方封装包直接调用，适合对样式还原度要求极高的场景。
• DomPDF：纯PHP实现的转换库，不需要额外安装系统依赖，CSS支持度优于TCPDF，部署简单，适合中小规模的文档生成需求。

内容的提问来源于stack exchange，提问作者Trombone0904