跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScript大前端

jsPDF 中文显示解决方案:字体引入与配置指南

jsPDF 默认不支持中文字符,需引入自定义 TTF 字体。核心方案是使用思源黑体等开源字体,通过官方 fontconverter 工具将 TTF 转为 JS 格式,并在代码中调用 addFont 和 setFont 方法加载。步骤涵盖准备字体、转换格式、引入使用。常见问题包括乱码、文件名不匹配及文件体积大,可通过子集裁剪优化。该流程可实现 PDF 生成中的中文完美显示。

嘘发布于 2026/3/30更新于 2026/10/24141 浏览

jsPDF 中文显示解决方案:字体引入与配置指南

jsPDF 默认只支持 14 种标准 PDF 字体(Helvetica、Times 等),完全不支持中文字符,导致中文显示为方框或乱码。 核心解决办法:引入支持中文的自定义字体(TTF → 转换 → 加载)。

2025-2026 年最推荐、最稳定的方式是使用思源黑体 / 思源宋体 / Noto Sans CJK 等免费开源字体,并通过官方推荐的转换工具处理。

步骤 1:准备中文字体文件(.ttf)

选择体积适中、支持简体中文的字体(推荐以下任一):

  • 思源黑体(Source Han Sans):现代感强,推荐
    • 下载地址:https://github.com/adobe-fonts/source-han-sans(选择 OTC 或 TTF 版本,建议 SC 简体中文子集)
  • 思源宋体(Source Han Serif):更正式的场景
  • Noto Sans CJK SC:Google 出品,覆盖全面
    • https://fonts.google.com/noto/specimen/Noto+Sans+SC
  • 更小的子集字体(推荐生产环境):使用工具裁剪只保留常用汉字,文件可从几 MB 降到几百 KB

小技巧:字体文件越小,PDF 生成越快、文件体积越小。优先找'简体中文子集'版本。

步骤 2:将 TTF 转换为 jsPDF 可用的 JS 格式

jsPDF 官方提供了字体转换工具(fontconverter),将 TTF 转为 base64 + 字体定义的 JS 文件。

操作方式(最简单两种,任选其一):

方式 A:在线转换(推荐新手)

  1. 打开 jsPDF 官方在线转换器(或 fork 版本):
    • https://rawgit.com/MrRio/jsPDF/master/fontconverter/fontconverter.html
    • 或 https://peckconsulting.s3.amazonaws.com/fontconverter/fontconverter.html
  2. 拖入或选择你的 .ttf 文件(例如:SourceHanSansCN-Normal.ttf)
  3. 自动填充:
    • Font name:自定义(如 'SourceHanSansCN')
    • Font style:normal(或 bold/italic 根据实际情况)
  4. 点击 Convert → 下载生成的 JS 文件(例如:SourceHanSansCN-normal.js)

方式 B:本地转换(项目多字体时推荐)

  1. 打开 jsPDF/fontconverter/fontconverter.html(浏览器直接打开)
  2. 同上操作,生成 JS 文件

克隆 jsPDF 仓库:

git clone https://github.com/parallax/jsPDF.git 

生成的文件内容大致是:

(function(jsPDFAPI){var font ='AAEAAA...';// base64 编码的字体数据(很长)
jsPDFAPI.addFileToVFS('SourceHanSansCN-Normal.ttf', font);
jsPDFAPI.addFont('SourceHanSansCN-Normal.ttf','SourceHanSansCN','normal');
})(jsPDF.API);
步骤 3:在代码中引入并使用中文字体

完整示例代码(Vue/React/纯 JS 通用)

<!-- 1. 引入 jsPDF -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/jspdf/2.5.1/jspdf.umd.min.js"></script>
<!-- 2. 引入你转换后的字体文件(推荐放 public 或 static 目录) -->
<script src="./fonts/SourceHanSansCN-normal.js"></script>
<script>
// 3. 生成 PDF
function generatePDF() {
  const { jsPDF } = window.jspdf;
  const doc = new jsPDF();
  // 设置中文字体(必须在 text 之前调用)
  doc.setFont('SourceHanSansCN','normal'); // 字体名要和 addFont 时一致
  // 可选:设置字体大小
  doc.setFontSize(16);
  // 输出中文(现在不会乱码了)
  doc.text('你好,世界!这是一个支持中文的 jsPDF 示例。', 20, 30);
  // 支持混合中英文
  doc.text('Hello, 这是一段中英混合文本,完美显示~', 20, 50);
  // 如果有粗体需求(需单独转换 bold 版本)
  // doc.setFont('SourceHanSansCN', 'bold');
  doc.save('中文 PDF 示例.pdf');
}
// 调用
// generatePDF();
</script>
常见问题 & 解决方案速查表
问题原因解决办法
仍然方框/乱码没调用 setFont必须在 text 前 doc.setFont('你的字体名')
字体名找不到(warning)addFont 的名称不匹配确认 addFont 的第 2 个参数(字体家族名)
PDF 文件超大完整 TTF 文件太大使用字体子集工具裁剪(只保留常用汉字)
转换后文件报错jsPDF 版本不兼容建议用 2.5.x 版本 + 对应转换工具
多人协作 / CDN 加载字体 JS 文件太大上传到 OSS/CDN,动态 import 或 xhr 加载
AutoTable 中文也乱码AutoTable 需要单独设置字体table.styles.font = '你的字体名'
推荐字体组合(生产级)
  • 正常文本:SourceHanSansCN-Normal
  • 粗体:SourceHanSansCN-Bold(需单独转换)
  • 标题:SourceHanSerifCN-Bold(宋体风格)

总结: 下载 TTF → 用 fontconverter 转成 JS → 引入 + setFont → 中文完美显示 整个过程最长不超过 10 分钟,就能彻底告别中文乱码。

目录

  1. jsPDF 中文显示解决方案:字体引入与配置指南
  2. 步骤 1:准备中文字体文件(.ttf)
  3. 步骤 2:将 TTF 转换为 jsPDF 可用的 JS 格式
  4. 步骤 3:在代码中引入并使用中文字体
  5. 常见问题 & 解决方案速查表
  6. 推荐字体组合(生产级)

更多推荐文章

查看全部
  • PHP 网络安全渗透测试靶场:5 大基础漏洞实战
  • 9 篇大模型领域前沿论文精选
  • OpenClaw 智能体框架:环境搭建、模型配置与远程访问实战
  • DuckX:C++操作 Word 文档的完整指南
  • 大模型是否会取代程序员?探讨未来技术职场变化
  • C++ vector 容器:底层原理、扩容机制与实战用法详解
  • LeetCode 热题 100 快速通关指南(附模板)
  • 基于 SpringBoot 的医院住院管理系统设计与实现
  • C++ STL 常用容器 vector、set 与 string 用法详解
  • Python IDLE 汉化方法
  • 30dayMakeCppServer:构建高性能C++网络服务器实践
  • 利用 AI 快速开发 Microsoft Visual C++ 应用
  • Stable Diffusion 图生视频实战:从一张图到一段动画
  • C++ 容器适配器:从接口到实现,理解 stack、queue 和 priority_queue
  • Diffusion Transformer (DiT):U-Net 换 ViT,应用于视频生成与机器人动作预测
  • 中国人工智能大模型技术白皮书核心内容总结
  • 自然语言处理在金融领域的应用与实战
  • AI Agent 架构:基础组成模块深度解析
  • Qwen3-VL 结合 Dify 实现 OCR 增强与空间感知实战
  • 基于指数预定义时间控制的固定翼无人机轨迹跟踪控制(Matlab 仿真)

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online