术语表

反序列化(unmarshal)

把序列化对象转换为可在模板中访问的数据结构。

难度
参考

开始之前,你需要

  • 在文档里遇到不认识的 Hugo 术语时查阅

读完之后你能

  • 判断模板里取不到数据是解析失败,还是键名大小写不一致造成的

接着读:Unmarshal

反序列化(unmarshal,动词)是把序列化对象转换为数据结构。例如,把 JSON 文件转换为可在模板中访问的 map。

参见:transform.Unmarshal

为什么重要

要把 data/ 目录下的 JSON、YAML、TOML 文件,或模板里拿到的 JSON 字符串变成可用的数据,就得先反序列化,否则它只是一段字符串,取字段一律为空。它的反向操作是 marshal,两者常在同一条数据处理链上出现。失败往往分两种:格式错误会直接报错并带上 transform.Unmarshal;格式没错但键名大小写与文件里写的不一致时不会报错,只会取到 nil,页面渲染成空白。

延伸阅读:transform.Unmarshal、数据源