Go x/image/font/opentype ParseCollection 怎样读取字体集合

读取 TTC、OTC 字体集合时，可以用 opentype.ParseCollection(data) 得到集合，再通过 NumFonts() 获取数量，用 Font(index) 选择其中一个字体。索引从 0 开始；单个 TTF、OTF 文件也可以走这个入口，会返回只有一个字体的集合。选出的字体仍依赖原始数据，因此使用期间不能改写那段字节。

官方地址：https://pkg.go.dev/golang.org/x/image/font/opentype

先用集合入口读取并选择字体

下面把文件读取、集合解析、索引检查和选取字体封装在同一个函数中。调用方传入自己有权使用的字体文件路径及索引；函数返回解析后的字体对象，不负责配置字号或绘制文字。

package fontload

import (
    "fmt"
    "os"

    "golang.org/x/image/font/opentype"
)

// LoadFont 按集合内的零起始索引选取字体，也接受单字体文件。
func LoadFont(path string, index int) (*opentype.Font, error) {
    data, err := os.ReadFile(path)
    if err != nil {
        return nil, fmt.Errorf("读取字体文件: %w", err)
    }
    // data 是本次读取获得的独立字节切片，返回后也不再修改它。
    collection, err := opentype.ParseCollection(data)
    if err != nil {
        return nil, fmt.Errorf("解析字体集合: %w", err)
    }
    count := collection.NumFonts()
    if index = count {
        return nil, fmt.Errorf("字体索引 %d 超出范围，字体数 %d", index, count)
    }
    // 集合解析成功后，取得具体字体仍需单独处理错误。
    selected, err := collection.Font(index)
    if err != nil {
        return nil, fmt.Errorf("读取集合内字体 %d: %w", index, err)
    }
    return selected, nil
}

项目需要依赖 golang.org/x/image 模块。请按项目的 Go 版本和依赖管理策略选择模块版本。这里的代码用于说明 API 的组合方式，未附带某个字体文件的运行结果，也不假设所有集合都有相同的字形覆盖。

为什么单字体读取逻辑需要调整

原来只处理 TTF、OTF 的代码常直接调用 opentype.Parse，得到一个字体对象。增加集合文件支持后，调用方必须补充“选哪一个字体”这个参数。不要把扩展名改成 ttf，或者把整个 TTC 数据交给单字体入口，希望它自动选中预期字重。

这是输入能力扩展的设计选择，不代表某个新版本刚增加了该函数。统一入口能减少根据扩展名分支的代码；文件是否可解析仍由实际数据和 API 返回结果决定。

把索引选择和字体名称分开

NumFonts() 返回字体数量，不是字形数量。Font(1) 表示集合内第二项，不表示粗体，也不表示第二种语言。集合的排列由文件内容决定，替换字体文件后，原来的索引未必仍对应同一款字体。

如果业务允许用户选择字体，先列出可用项，再保存文件标识和索引。文件更新时重新确认映射。如果要求按名称、字重或字符覆盖选择，需要另行读取相应信息并建立选择规则；ParseCollection 本身不会替你做这种匹配。默认索引 0 只能作为明确的产品约定，不能解释成“自动找到最合适字体”。

保留底层字节的只读生命周期

opentype.Collection 是 sfnt.Collection 的类型别名。底层文档要求，在集合或其中字体还被使用时，不要修改传入的 src。示例通过 ReadFile 获得数据后不再暴露可写切片，让返回的字体继续持有所需数据；局部变量离开函数并不意味着 Go 会立即释放仍被引用的底层存储。

如果输入来自可复用的网络缓冲区或字节池，应在交给解析器之前取得独立副本，并在字体使用期间保持其内容稳定。不要解析完就把同一块存储放回池里让其他请求覆盖。这里的“独立”指底层字节存储，不只是复制一个切片变量。

若选择 ParseCollectionReaderAt，它接收 io.ReaderAt。官方文档要求集合或字体使用期间既不能修改数据源，也不能关闭它。因此不能在返回字体的加载函数里先 defer 关闭源文件，再让外层继续使用那个字体。可将文件和字体一起封装，由使用方在全部工作结束后关闭，或使用示例中的内存读取方式。

区分解析错误与后续绘制配置

建议保留示例中三个不同的错误位置：文件读取失败、集合解析失败、具体字体选取失败。索引越界应在调用 Font 之前给出包含数量的错误。不要把所有错误都压成“字体不存在”，否则无法区分路径问题、数据问题和配置问题。

得到 *opentype.Font 后，如果要用它绘字，还需要 opentype.NewFace 和字号、DPI 等选项。字体集合索引与字号不是同一个维度，重复选择同一索引不会产生另一种字号。Face 文档也明确它不能安全地并发使用；不要因为集合方法可以并发调用，就推断同一个绘制 Face 也能被任意协程共享。

常见问题：普通 TTF 能不能用这套函数？可以，成功解析后集合只有一项。数量大于一是否就能默认第二项为粗体？不能，应建立文件对应的选择规则。ParseCollection 成功是否意味着整条渲染链已成功？不意味着，取得字体和创建绘制对象的错误仍要分别处理。

实际改造时，重点是把输入读取从“一个文件必定对应一个字体”调整为“一个文件对应可索引的集合”，再把源数据寿命与字体使用寿命放在一起管理。

参考：opentype 官方 API 文档；sfnt 数据源约定。