> For the complete documentation index, see [llms.txt](https://twig.shujuwajue.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://twig.shujuwajue.com/twig-2x/bian-ma-biao-zhun.md).

# 编码标准

> 原文：[Coding Standards](https://twig.sensiolabs.org/doc/2.x/coding_standards.html)\
> 翻译：小虾米（QQ:509129）

## 编码标准

在编写Twig模板时，我们建议您遵循以下官方编码标准:

* 在分隔符({、{ %和{ #)的开头和分隔符(}、% }和# }结束之前)放置一个(和仅一个)空格。

```markup
{{ foo }}
{# comment #}
{% if foo %}{% endif %}
```

当使用空格控制字符时，不要在它和分隔符之间放置空格:

```
{{- foo -}}
{#- comment -#}
{%- if foo -%}{%- endif -%}
```

* 在下列操作符前后放置一个(并且只有一个)空格:比较运算符(= =，!=、<、>、> =、< =)、数学操作符(+、-、/、\* %,/ / \* \*),逻辑运算符(,,),\~,,,和三元操作符(?):

```markup
{{ 1 + 2 }}
{{ foo ~ bar }}
{{ true ? true : false }}
```

* 放置一个(并且只有一个)空格:在散列中，在数组和散列中:

```markup
{{ [1, 2, 3] }}
{{ {'foo': 'bar'} }}
```

* 在开括号之后，不要在括号结束之前放任何空格。

```markup
{{ 1 + (2 * 3) }}
```

* 在字符串分隔符之前和之后，不要放置任何空格:

```markup
{{ 'foo' }}
{{ "foo" }}
```

* 在下列操作符之前和之后，不要放置空格|, ., .., \[]:

```
{{ foo|upper|lower }}
{{ user.name }}
{{ user[name] }}
{% for i in 1..12 %}{% endfor %}
```

* 不要在括号之前和之后放置任何空格，用于过滤和函数调用:

```
{{ foo|default('foo') }}
{{ range(1..10) }}
```

* 在打开和结束数组和散列之后，不要放置任何空格。

```
{{ [1, 2, 3] }}
{{ {'foo': 'bar'} }}
```

* 使用小写和下划算来命名变量名:

```markup
{% set foo = 'foo' %}
{% set foo_bar = 'foo' %}
```

* 在标签内缩进你的代码(使用与已呈现模板的目标语言相同的缩进):

```markup
{% block foo %}
    {% if true %}
        true
    {% endif %}
{% endblock %}
```