brace-style

强制块级代码的一致花括号风格

🔧

此规则报告的一些问题可以通过--fix 命令行选项自动修复。

此规则已在 ESLint v8.53.0 中**弃用**。请在相应的规则中使用@stylistic/eslint-plugin-js。

花括号风格与编程中的缩进风格密切相关，并描述了花括号相对于其控制语句和主体的位置。世界上可能存在十几种，甚至更多，花括号风格。

一种真正的花括号风格是 JavaScript 中最常见的花括号风格之一，其中块的开始花括号放置在其对应的语句或声明的同一行上。例如

if (foo) {
  bar();
} else {
  baz();
}
1
2
3
4
5

一种真正的花括号风格的一个常见变体称为 Stroustrup，其中if-else结构中的else语句以及catch和finally必须在其前面的结束花括号之后位于单独的一行上。例如

if (foo) {
  bar();
}
else {
  baz();
}
1
2
3
4
5
6

另一种风格称为Allman，其中所有花括号都应位于单独的行上，没有任何额外的缩进。例如

if (foo)
{
  bar();
}
else
{
  baz();
}
1
2
3
4
5
6
7
8

虽然没有一种风格被认为比其他风格更好，但大多数开发人员都同意，在整个项目中保持一致的风格对于其长期可维护性非常重要。

规则详情

此规则强制块级代码的一致花括号风格。

选项

此规则有一个字符串选项

"1tbs"（默认值）强制使用一种真正的花括号风格
"stroustrup"强制使用 Stroustrup 风格
"allman"强制使用 Allman 风格

此规则有一个对象选项用于例外情况

"allowSingleLine": true（默认值为false）允许块的开始和结束花括号位于同一行上

1tbs

使用默认"1tbs"选项时，此规则的错误代码示例

在 Playground 中打开

/*eslint brace-style: "error"*/

function foo()
{
  return true;
}

if (foo)
{
  bar();
}

try
{
  somethingRisky();
} catch(e)
{
  handleError();
}

if (foo) {
  bar();
}
else {
  baz();
}

class C
{
    static
    {
        foo();
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

使用默认"1tbs"选项时，此规则的正确代码示例

在 Playground 中打开

/*eslint brace-style: "error"*/

function foo() {
  return true;
}

if (foo) {
  bar();
}

if (foo) {
  bar();
} else {
  baz();
}

try {
  somethingRisky();
} catch(e) {
  handleError();
}

class C {
    static {
        foo();
    }
}

// when there are no braces, there are no problems
if (foo) bar();
else if (baz) boom();
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

使用"1tbs", { "allowSingleLine": true }选项时，此规则的正确代码示例

在 Playground 中打开

/*eslint brace-style: ["error", "1tbs", { "allowSingleLine": true }]*/

function nop() { return; }

if (foo) { bar(); }

if (foo) { bar(); } else { baz(); }

try { somethingRisky(); } catch(e) { handleError(); }

if (foo) { baz(); } else {
  boom();
}

if (foo) { baz(); } else if (bar) {
  boom();
}

if (foo) { baz(); } else
if (bar) {
  boom();
}

if (foo) { baz(); } else if (bar) {
  boom();
}

try { somethingRisky(); } catch(e) {
  handleError();
}

class C {
    static { foo(); }
}

class D { static { foo(); } }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

stroustrup

使用"stroustrup"选项时，此规则的错误代码示例

在 Playground 中打开

/*eslint brace-style: ["error", "stroustrup"]*/

function foo()
{
  return true;
}

if (foo)
{
  bar();
}

try
{
  somethingRisky();
} catch(e)
{
  handleError();
}

class C
{
    static
    {
        foo();
    }
}

if (foo) {
  bar();
} else {
  baz();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

使用"stroustrup"选项时，此规则的正确代码示例

在 Playground 中打开

/*eslint brace-style: ["error", "stroustrup"]*/

function foo() {
  return true;
}

if (foo) {
  bar();
}

if (foo) {
  bar();
}
else {
  baz();
}

try {
  somethingRisky();
}
catch(e) {
  handleError();
}

class C {
    static {
        foo();
    }
}

// when there are no braces, there are no problems
if (foo) bar();
else if (baz) boom();
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

使用"stroustrup", { "allowSingleLine": true }选项时，此规则的正确代码示例

在 Playground 中打开

/*eslint brace-style: ["error", "stroustrup", { "allowSingleLine": true }]*/

function nop() { return; }

if (foo) { bar(); }

if (foo) { bar(); }
else { baz(); }

try { somethingRisky(); }
catch(e) { handleError(); }

class C {
    static { foo(); }
}

class D { static { foo(); } }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

allman

使用"allman"选项时，此规则的错误代码示例

在 Playground 中打开

/*eslint brace-style: ["error", "allman"]*/

function foo() {
  return true;
}

if (foo)
{
  bar(); }

try
{
  somethingRisky();
} catch(e)
{
  handleError();
}

class C {
    static {
        foo();
    }
}

if (foo) {
  bar();
} else {
  baz();
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

使用"allman"选项时，此规则的正确代码示例

在 Playground 中打开

/*eslint brace-style: ["error", "allman"]*/

function foo()
{
  return true;
}

if (foo)
{
  bar();
}

if (foo)
{
  bar();
}
else
{
  baz();
}

try
{
  somethingRisky();
}
catch(e)
{
  handleError();
}

class C
{
    static
    {
        foo();
    }
}

// when there are no braces, there are no problems
if (foo) bar();
else if (baz) boom();
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

使用"allman", { "allowSingleLine": true }选项时，此规则的正确代码示例

在 Playground 中打开

/*eslint brace-style: ["error", "allman", { "allowSingleLine": true }]*/

function nop() { return; }

if (foo) { bar(); }

if (foo) { bar(); }
else { baz(); }

try { somethingRisky(); }
catch(e) { handleError(); }

class C
{
    static { foo(); }

    static
    { foo(); }
}

class D { static { foo(); } }
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

何时不使用它

如果您不想强制执行特定的花括号风格，请不要启用此规则。

版本

此规则是在 ESLint v0.0.7 中引入的。

进一步阅读

缩进风格 - 维基百科
en.wikipedia.org

资源

编辑此页面

brace-style

规则详情

选项

1tbs

stroustrup

allman

何时不使用它

相关规则

版本

进一步阅读

资源