揭秘 Libre Barcode 的魔法:一行普通文本如何被字体引擎渲染成条形码
揭秘 Libre Barcode 的魔法:一行普通文本如何被字体引擎渲染成条形码
Libre Barcode 是一套开源条形码字体,覆盖 Code 39、Code 128 与 EAN/UPC 13 三大标准。它让你无需调用绘图 API,只需在文档里输入一行普通文本,字体引擎就会在屏幕上"变出"真正可扫描的条形码——这正是本文要拆开的完整魔法链路。
条形码字体是什么:把图案"藏"进字形里
传统做法是用库生成条形码图片,粘贴进文档。Libre Barcode 换了个思路:把每一段条纹图案直接做成字体里的字形。你打的还是文本,文档里存的还是可搜索、可复制的字符,但渲染出来却是黑白色条——这就是 fonts/ 目录下这些字体的作用:
| 字体文件 | 覆盖标准 | 特点 |
|---|---|---|
| LibreBarcode39-Regular.ttf | Code 39 | 纯条码 |
| LibreBarcode39Text-Regular.ttf | Code 39 | 条码下方带文字 |
| LibreBarcode39Extended-Regular.ttf | Code 39 扩展 | 支持完整 ASCII |
| LibreBarcode128-Regular.ttf | Code 128 | 纯条码 |
| LibreBarcode128Text-Regular.ttf | Code 128 | 条码下方带文字 |
| LibreBarcodeEAN13Text-Regular.ttf | EAN/UPC 家族 | EAN-13、EAN-8、UPC-A、UPC-E 及附加码 |
💡 字体以 OFL 开源协议发布(见 fonts/OFL.txt),编码器则为 GPL3+,可自由商用与二次分发。
魔法第一步:编码器把文本变成"魔法字符串"
直接打 001234567890? 是不会自动变成条码的(部分场景需要),大多数情况需要一个编码器把输入翻译成正确的字形序列。三种标准的套路各不相同:
Code 39:用星号包住文本
最简单的规则:把要编码的内容用 * 星号包裹,输入 *HELLO WORLD* 即可,具体见 documentation/code39.md。
⚠️ 小坑:Extended 变体支持完整 ASCII(小写 a 内部被拆成 +A 两个符号),但有些扫描器会把它读成普通 Code 39,解出 H+E+L+L+O——使用时留意兼容性。
Code 128:自动选最短条码的优化编码器
Code 128 有 A、B、C 三个码集(C 集用一个符号编码两位数字,特别紧凑)。Libre Barcode 配套的编码器是优化型的:它会在 A/B/C 之间智能切换,输出能编码该输入的最短条码,并自动计算校验位——你只管输入,长度优化它包了。
核心实现在 app/lib/code128Encoder/encoder.mjs,每张文档页都嵌了一个在线编码器(web_assets/js/code128encoder.mjs),输入后实时预览。
EAN/UPC:只输数字,问号代替校验位
这是全项目最"懒人友好"的设计——documentation/ean13.md 的原话:"Enter your digits, the font does all the rest."
- 不知道校验位?在末尾放一个
?占位,例如001234567890?,字体自动算出来 - 想生成 UPC-E?短格式加小写
x前缀,长格式加大写X - 附加码直接在主码后面追加 2 位或 5 位数字
魔法第二步:字体引擎的 OpenType calt 特性
数字输进去了,为什么渲染出来是条码?秘密藏在字体内部的 OpenType 特性里。
以 EAN-13 为例,复杂度极高:
- 每个数字对应 3 种图案变体(Set A / B / C),通过混排方式还能编码额外信息
- 不同符号类型(EAN-13、UPC-E……)还需要插入不同的"守卫(guard)"条纹
- 最终每个数字在字体里多达 13 个不同字形
这些复杂的替换、选图逻辑全部写在字体的 calt(Contextual Alternates)特性 里。现代文本渲染管线(浏览器、桌面软件)默认会执行它——所以你在支持的软件里敲下 001234567890?,shaping 阶段字体引擎就把普通数字逐位替换成带条纹的字形,并自动补上起止守卫图案。
Code 128 的 calt 规则同样精彩(见 app/lib/builder/code128.js):紧挨结束符的校验位符号会自动换成"不带下方文字"的版本,因为校验位本身对人类不可读,没必要印出来。
📌 个别软件(如 Microsoft Word)默认不启用该特性,需要在字体设置里手动打开"Contextual Alternates",documentation/ean13.md 里有逐步说明。
魔法第三步:字形本身是怎么"画"出来的
打开 app/lib/builder/ean13.js 就能看到魔法的原料——每条黑白色条都是一串简单的宽度数组:
[0, [3, 2, 1, 1], 'zero'] // 数字 0:条/空交替,宽度 3-2-1-1
[1, [2, 2, 2, 1], 'one'] // 数字 1
构建器按 app/lib/builder/abstract.js 里的流程,把这些"宽度配方"翻译成矢量轮廓(drawPoints),再拼成复合字形:
- 画基础符号:
drawRawSymbols把每个图案写进字体 - 拼复合字形:带"下方文字"的版本会缩放嵌入一个普通字体(如 Inconsolata)的字形,放在条码正下方
- 写 OpenType 特性:
getFeatures输出calt规则
构建入口 app/lib/builder.js 选择对应 Builder 并落盘为 UFO 源码,最终产物就是我们开头列出的 .ttf 字体文件。
没有 OpenType 支持怎么办?两条后路
并非所有环境都能执行 calt。Libre Barcode 准备了两套备选输入法:
- Fallback 输入法:字体的所有字形都注册了 Unicode 编码,可以直接"手打"出来。但字符串晦涩难懂,不能指望人肉编码——于是项目内置了一个聪明的编码器:它用 Harfbuzz-JS(WebAssembly 版 shaping 引擎)在浏览器里执行真实的字体 shaping,再把结果字形反查回 Unicode 码点输出。由于用的是同一份字体,输出永远与
calt路径完全一致,维护成本极低。逻辑见 app/lib/ean13Encoder/fallback.mjs - Compatible 输入法:与开源字体 Grandzebu 的 EAN 13 编码兼容,方便复用现成的 VBA/Excel 编码工具,适合完全无 OpenType 能力的软件(如旧版 Excel)
测试与批量编码页面分别见 documentation/ean13-testing.md 与 documentation/ean13-bulk.md。
快速上手三步走
- 克隆项目:
git clone https://gitcode.com/gh_mirrors/li/librebarcode - 获取字体:直接用现成的 fonts/ 目录,或按 README.md 的步骤(
npm install+uv sync+uv run ./app/bin/buildAll)自行构建 - 使用:在支持的软件中选用字体,用上面的规则输入文本(Code 39 加星号、EAN 数字串可带
?),需要转换时借助文档页里的在线编码器
相关文件导航
- 字体成品:fonts/
- Code 128 文档与编码器:documentation/code128.md、app/lib/code128Encoder/encoder.mjs
- EAN/UPC 构建器与
calt规则:app/lib/builder/ean13.js、app/lib/builder/code128.js - 字形构建基类:app/lib/builder/abstract.js
- Fallback 编码器(Harfbuzz-JS + opentype.js):app/lib/ean13Encoder/fallback.mjs
- 许可协议:OFL.txt
一句话总结
Libre Barcode 的"魔法"= 模式化字形 + 优化编码器 + OpenType calt shaping 三层协作:字体把条纹变成图形,编码器把文本变成符号序列,字体引擎在渲染瞬间完成最后的拼装——于是普通文本,就这样长出了可以被扫描枪识破的条形码。