PHP如何用TCPDF生成PDF实战

TCPDF 初始化失败主因是自动加载未生效或字体/路径配置错误；须用Composer安装并使用完整命名空间，中文需先addTTFfont()注册再setFont()指定，writeHTML()仅支持有限内联样式且要求绝对路径和严格标签闭合。

TCPDF 初始化失败：空白页或 Fatal error

常见现象是调用 TCPDF 后直接报 Fatal error: Class 'TCPDF' not found，或者生成 PDF 是空白页、只显示“TCPDF Example”。本质是自动加载没走通，或字体/路径配置错。

实操建议：

• 确认已通过 Composer 安装：composer require tecnickcom/tcpdf，别手动下载 ZIP 放目录里——类名空间和自动加载会出问题
• 初始化必须用完整命名空间：use TCPDF\TCPDF;，然后 $pdf = new TCPDF();，不能写 new TCPDF() 前不 use
• 如果用在旧项目（无 Composer），得手动 require 所有核心文件，但强烈不推荐——tcpdf.php 依赖 tcpdf_fonts.php 和 tcpdf_static.php，漏一个就白屏
• 中文乱码或空白？默认不带中文字体。必须显式添加：先用 addTTFfont() 注册一个 .ttf 文件（如 simhei.ttf），再用 setFont() 切换，否则 writeHTML() 里的中文全丢

writeHTML() 渲染失败：样式丢失、换行异常、图片不显示

writeHTML() 看似像浏览器渲染 HTML，实际是 TCPDF 自研的轻量解析器，CSS 支持极弱，且对标签闭合敏感。很多前端写的 HTML 直接粘过去就崩。

实操建议：

• 只用内联 style，别依赖外部 CSS 或