使用Ligaturizer实现"Google Fira Code"字体|乐天派

前言：当鱼和熊掌可以兼得

作为开发者，我们总是在追求完美的编程字体。有时我们喜欢 `Google Sans Code` 的现代感和清晰度，但又垂涎于 `Fira Code` 那强大的编程连字（Ligatures）功能，它能将 `=>`、`!=` 等符号变成更易读的 `⇒`、`≠`。我们能不能将二者合一，创造一款既有 `Google Sans Code` 的“颜”，又有 `Fira Code` 的“魂”的字体呢？答案是肯定的。通过开源工具，我们可以亲手“锻造”这样一款字体。这篇博客将根据一次完整的实践探索，总结出使用自动化连字脚本 `FiraCode-based-ligaturizer` 为任意字体添加连字的终极指南。

第一步：环境准备：安装必要的“铸字”工具

本教程的操作环境为 **Debian 12**，但其核心步骤和命令适用于大多数 Linux 发行版。我们需要安装几个核心工具：`git` 用于下载项目，`make` 用于执行构建，以及最重要的 `fontforge` 及其 Python 模块。打开终端，执行以下命令一次性安装所有依赖：

sudo apt update && sudo apt install git make fontforge python3-fontforge

避坑指南：`fontforge` 与 `python3-fontforge` 的区别

在我最初的尝试中，遇到了两个常见的错误，理解它们能帮你节省大量时间：

Package python-fontforge is not available: 在较新的 Debian/Ubuntu 系统中，Python 2 的包 python-fontforge 已被废弃，应使用 Python 3 版本 python3-fontforge。
fontforge: command not found: 只安装 python3-fontforge 是不够的。它仅仅是 fontforge 的 Python 模块（让 Python 脚本能调用其功能），你还需要安装 fontforge主程序本身，它提供了可从命令行执行的工具。

因此，上面的安装命令同时包含了这两者，确保万无一失。

第二步：获取“配方”：克隆连字脚本

我们将使用一个基于 FontForge 的自动化脚本。在克隆项目时，必须使用 --recurse-submodules 参数，因为它依赖于 Fira Code 作为子模块来获取连字源。

git clone --recurse-submodules https://github.com/casparw/FiraCode-based-ligaturizer.git

下载完成后，进入项目目录：

cd Ligaturizer/

第三步：准备“原料”：放入你的目标字体

将你希望添加连字的字体文件（.ttf 或 .otf 格式）复制到项目的 fonts/ 目录中。

例如，如果你想改造 Google Sans Code 的多个字重版本，可以执行：

# 假设你的原始字体文件在 ~/Downloads/Google_Sans_Code 目录
cp ~/Downloads/Google_Sans_Code/*.ttf fonts/google/

第四步：修改“蓝图”：配置构建脚本

我们需要告诉脚本，我们想要处理哪些字体。

用文本编辑器打开 build.py 文件：
```
nano build.py
```

在文件中找到 prefixed_fonts 列表。将你的字体名称（需扩展名，可使用 * 通配符）添加进去。
例如，要处理所有 GoogleSansCode 的字体，可以这样修改：

# build.py

# ...
prefixed_fonts = [
#   # Apache 2.0 license
#   'fonts/codeface/fonts/cousine/*.ttf',
#   'fonts/codeface/fonts/droid-sans-mono/*.ttf',
#   'fonts/codeface/fonts/meslo/*.ttf',
#   'fonts/codeface/fonts/roboto-mono/*.ttf',
  # Google Sans Code
  'fonts/google/*.ttf',
  'fonts/google/*.ttf',
]
# ...

保存并退出编辑器 (在 nano 中是 Ctrl+O, Enter, Ctrl+X)。

第五步：开始“锻造”：执行构建命令

一切就绪，只需一个命令即可开始字体合成：

make

脚本会自动扫描 fonts/ 目录，找到与你在 build.py 中配置的名称相匹配的字体，并开始处理。成功后，你可以在 fonts/output/ 目录中找到所有生成的新字体。它们会自动被加上 "Liga" 前缀。

Bash

ls -l fonts/output/
# 你会看到类似 LigaGoogleSansCode-Regular.ttf 的文件

第六步：常见问题与日志解读（经验之谈）

在处理过程中，你可能会遇到一些日志信息，绝大部分是无害的警告。

问题 1：处理“可变字体”时的警告

如果你处理的是可变字体（Variable Font），会看到类似日志： Ignoring 'HVAR' horizontal metrics variations table

含义：FontForge 忽略了字体中关于“可变”特性的数据表。
影响：生成的新字体将失去可变性，变为普通的静态字体。对于在代码编辑器中使用，这几乎没有影响。如果你需要保留可变性，建议一开始就使用静态版本的字体文件进行合成。

问题 2：构建中途崩溃 `OSError: ... already exists`

这个错误，通常发生在你第二次运行 make 时。

含义：脚本试图处理一个已经被处理过的字体文件，当它想再次添加连字规则时，发现规则已存在，于是程序崩溃。
根本原因：你不小心将 fonts/output/ 目录下的 Liga... 字体文件复制回了 fonts/ 输入目录。
黄金法则：永远保持输入 (fonts/) 和输出 (fonts/output/) 目录的纯净和分离。
解决方案：
1. 清理输入目录中所有被污染的文件：rm fonts/Liga*
2. 清理输出目录，重新开始：rm fonts/output/*
3. 再次运行 make。