# 本地化过滤器

Localization filters 使您能够根据客户的语言区域自定义元素的语言和格式。

## t

`string | t`

returns  [string](../basics/liquid-types#string)

从 [locale 文件](/zh-CN/docs/theme/architecture/locales/overview)中根据给定的翻译键返回已翻译的文本字符串。

**提示**

要了解更多关于使用 `t` filter 的内容，请参阅[店铺前端 locale 文件使用说明](/zh-CN/docs/theme/architecture/locales/storefront-locale-files#%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E)。

翻译键必须以 `i18n.` 为前缀，后接 locale 文件中的键路径。

**代码**

```liquid
{{ 'i18n.products.product.sold_out' | t }}
```

传入命名参数即可将变量插值到翻译字符串中：

**代码**

```liquid
{{ 'i18n.products.product.save' | t: amount: 18.88 }}
```

**注意**

不支持基于数量的复数形态（如 `one`/`other` 对象）。每个键请使用扁平字符串，需要复数时在 Liquid 中自行处理。