# collections.Dictionary
> 根据给定的键值对创建一个映射（map）。
- 官方英文原文：https://gohugo.io/functions/collections/dictionary/
- 本页规范地址：https://hugozh.cn/functions/collections/dictionary/
- 最近更新：2026-10-02
- 最后提交：912b1d3 chore(site): 添加 static/CNAME（hugozh.cn），供 GitHub Pages 等平台绑定自定义域名
- 签名：collections.Dictionary [VALUE...]
- 返回类型：map[string]any
- 站点：Hugo 中文文档（https://hugozh.cn/）· 社区维护的非官方中文翻译，如有出入以官方英文原文为准

---
把键值对作为一个个独立参数传入：

```go-html-template
{{ $m := dict "a" 1 "b" 2 }}
```

上面会生成如下数据结构：

```json
{
  "a": 1,
  "b": 2
}
```

注意 `key` 既可以是 `string`，也可以是 `[]string`。后者可用于创建深层嵌套的结构，例如：

```go-html-template
{{ $m := dict (slice "a" "b" "c") "value" }}
```

上面会生成如下数据结构：

```json
{
  "a": {
    "b": {
      "c": "value"
    }
  }
}
```

要创建空映射：

```go-html-template
{{ $m := dict }}
```