ReportLab生成PDF中文乱码需注册中文字体并显式指定，如pdfmetrics.registerFont(TTFont('SimHei', 'fonts/simhei.ttf'))；表格换行用Paragraph+WORDWRAP；Web响应须设Content-Type: application/pdf；高并发下字体注册一次、样式用.clone()、避免全局修改。
reportlab 生成 PDF 时中文乱码怎么办
默认字体不支持中文，直接写 canvas.drawString() 或 Paragraph 会报 UnicodeEncodeError 或显示方块。核心是注册中文字体并显式指定。
- 下载一个 TTF 中文字体（如
simhei.ttf或NotoSansCJKsc-Regular.otf），放在项目目录下（例如fonts/子目录） - 用
pdfmetrics.registerFont()注册，再通过getFont()获取；或更稳妥地用addMapping()绑定到Helvetica等族名，让Paragraph自动 fallback - 避免用系统路径硬编码，推荐用
importlib.resources.files().joinpath()（Python 3.9+）或os.path.join(os.path.dirname(__file__), ...)定位字体文件
示例关键片段：
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.ttfonts import TTFont
<p>pdfmetrics.registerFont(TTFont('SimHei', 'fonts/simhei.ttf'))</p><h1>后续所有 Paragraph 都需显式设 fontName='SimHei'</h1><p>p = Paragraph("测试中文", styles['Normal'].clone('ch', fontName='SimHei'))立即学习“Python免费学习笔记（深入）”；
用 Platypus 动态拼报表时，表格内容换行和列宽怎么控制
Table 是最常用的动态报表组件，但默认行为容易撑破页面或截断文本。关键在 colWidths、rowHeights 和 wrap 策略。
-
colWidths推荐用比例数组（如[100, 200, *]）或None让 ReportLab 自动计算；避免固定像素值，否则在不同数据长度下易错位 - 单元格内多行文本必须用
Paragraph包裹，不能直接传字符串；否则Table不识别换行符\n - 设置
style时加('WORDWRAP', (0,0), (-1,-1), 'CJK')可启用中英文混排自动折行（需字体支持） - 若某列内容过长导致整表溢出，可先用
textwrap.fill(text, width=20)预处理，再传入Paragraph
Django/Flask 中返回 PDF 响应时常见 Content-Type 错误
浏览器打不开、提示“无法加载PDF”或直接下载成 .txt 文件，基本是响应头没设对。
- 必须设
Content-Type: application/pdf，不能是text/plain或漏掉 - 务必禁用缓冲：Django 用
HttpResponse(content_type='application/pdf')；Flask 用make_response()并设response.headers['Content-Type'] = 'application/pdf' - 不要用
StringIO（Python 3 已废弃），统一用io.BytesIO接收canvas.save()或SimpleDocTemplate.build()输出 - 调试时先用
with open('debug.pdf', 'wb') as f: f.write(buffer.getvalue())确认本地文件能正常打开，再查响应逻辑
reportlab 在高并发 Web 场景下的线程安全风险
pdfmetrics.getRegisteredFonts() 和全局字体注册是进程级的，但 canvas 和 SimpleDocTemplate 实例本身是线程安全的——问题出在「共享状态」误用。
- 切勿在模块顶层或全局变量里创建
canvas或复用SimpleDocTemplate实例；每个请求必须新建 - 字体注册（
registerFont）只做一次，在应用启动时（如 Django 的AppConfig.ready()或 Flask 的create_app里）完成即可 - 避免在绘制过程中修改
styles全局对象（如styles['Normal'].fontName = 'SimHei'），应调用.clone()创建新样式 - 内存泄漏隐患：大报表生成后未及时 del buffer / canvas，尤其在 Gunicorn 多 worker 下可能耗尽内存
真正难调试的是字体缓存和样式克隆链——一旦某个请求中途异常退出，可能留下不一致的样式状态，影响后续请求。建议所有样式操作封装成函数，每次调用都从干净的 getSampleStyleSheet() 开始。
