Go x/image/font/sfnt Parse 怎样读取字体名称表

如果程序需要从 TTF 或 OTF 文件中显示字体名称，关键不是把文件名当作字体名，而是先让 sfnt.Parse 得到 *sfnt.Font，再用 Font.Name 按 NameID 读取名称表。最常用的三个键是 NameIDFamily（字体族）、NameIDSubfamily（样式）和 NameIDFull（完整名称）。

需要特别记住：解析成功后，Font 仍然依赖传给 Parse 的字节数据。下面按数据流转来安排读取过程。

Parse 返回的 Font 为什么还依赖原始数据

sfnt 是 TTF、OTF 等 SFNT 字体的底层解码器。它不会把整个字体复制成一个与输入完全脱离的对象，所以传入的字节切片在 Font 使用期间不能被改写。

最小读取链路可以写成下面这样。示例使用模块内置的 gofont/goregular 字节，避免把本机字体路径写死在文章里。

package main

import (
	"fmt"
	"log"

	"golang.org/x/image/font/gofont/goregular"
	"golang.org/x/image/font/sfnt"
)

func main() {
	// Parse 只负责把 TTF/OTF 字节解释成 Font，不会替调用方管理输入字节的生命周期。
	f, err := sfnt.Parse(goregular.TTF)
	if err != nil {
		log.Fatalf("解析字体失败: %v", err)
	}

	var buf sfnt.Buffer
	name, err := f.Name(&buf, sfnt.NameIDFamily)
	if err != nil {
		log.Fatalf("读取字体族名称失败: %v", err)
	}
	fmt.Println("字体族:", name)
}

如果输入来自 os.File，对应的 *os.File 也不能在 ParseReaderAt 返回后立即关闭；只有不再使用 Font 时才释放它。

用 NameID 读取字体族名、样式名和完整名

Font.Name 的第二个参数不是普通整数，而是 sfnt.NameID。这样写比在业务代码里散落数字更容易读懂，也能直接表达你要取的是哪一类名称。

func readFontNames(data []byte) (map[string]string, error) {
	// data 在返回的 Font 仍被使用时必须保持不变；这里把名称一次读出后再交给上层。
	f, err := sfnt.Parse(data)
	if err != nil {
		return nil, fmt.Errorf("parse font: %w", err)
	}

	var buf sfnt.Buffer
	ids := []struct {
		key string
		id  sfnt.NameID
	}{
		{"family", sfnt.NameIDFamily},
		{"subfamily", sfnt.NameIDSubfamily},
		{"full", sfnt.NameIDFull},
	}
	result := make(map[string]string, len(ids))
	for _, item := range ids {
		// 名称表可能没有某个键；缺失时保留空值，不把它误判成 Parse 失败。
		value, err := f.Name(&buf, item.id)
		if err != nil {
			if err == sfnt.ErrNotFound {
				result[item.key] = ""
				continue
			}
			return nil, fmt.Errorf("read %s: %w", item.key, err)
		}
		result[item.key] = value
	}
	return result, nil
}

实践中通常把 family 作为分组键，把 subfamily 用于展示 Regular、Bold 等样式；full 更适合直接显示给用户。不要假设每一款字体都填满这三个字段。

名称为空时，先分清是哪一层出了问题

读取结果为空不等于解析失败。可以把问题分成三层：

• Parse 返回错误：输入不是可解析的 SFNT 字体，或者数据本身损坏，后续不应继续调用 Name。
• Name 返回 sfnt.ErrNotFound：字体能够解析，但指定的 NameID 没有对应值，应用应准备回退展示。
• 名称曾经读到，后来变得异常：检查原始 []byte 是否被复用或改写，以及 ParseReaderAt 使用的文件是否提前关闭。

这套分层很重要：名称缺失是数据内容问题，解析失败是输入格式问题，生命周期错误则是调用方资源管理问题，处理动作不能混在一起。

Parse 和 ParseReaderAt 怎样选择

当字体已经完整加载到内存，并且你能保证字节在整个读取期间保持不变时，使用 sfnt.Parse 最直接。若字体来自可随机读取的文件或其他 io.ReaderAt，可以使用 ParseReaderAt，但源对象同样不能在 Font 使用期间被修改或关闭。

Buffer 是可选的：不关心重复调用的分配时可以传 nil；关心效率时再复用一个 Buffer，但并发调用要为每次调用准备不同的 Buffer。

常见问题

为什么读取到的名称不是文件名？

文件名只是外部命名，Font.Name 读取的是字体内部的 name table。两者可以不同，展示字体信息时应以名称表为准。

能不能用 sfnt 修改字体名称？

不能。这个包提供解码和读取能力，没有用于从头构造或修改 TTF 的编码器；如果业务要改字体文件，应另找专门的字体编辑方案。

不确定字体有没有某个名称时怎么写？

把 sfnt.ErrNotFound 当成可处理的缺失分支，返回空值或业务回退名；只有其他错误才提升为读取失败。

总结一下：先保证原始字体数据的生命周期，再用 Parse 得到 Font，最后用语义明确的 NameID 读取族名、样式名和完整名。这样就能把“字体解析失败”“名称不存在”和“输入被提前释放”分开处理。