newline-after-var

要求或禁止在变量声明后使用空行

🔧

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

此规则在 ESLint v4.0.0 中已 **弃用**，并由 padding-line-between-statements 规则取代。

截至今天，在将变量声明与代码的其余部分分隔开方面没有一致性。一些开发人员在 var 语句和代码的其余部分之间留一个空行，例如

var foo;

// do something with foo
1
2
3

而另一些则根本不留任何空行。

var foo;
// do something with foo
1
2

问题在于当这些开发人员在一个项目中一起工作时。此规则强制执行一种编码风格，其中允许或不允许在 var、let 或 const 语句后使用空行。它有助于使整个项目的代码看起来一致。

规则详情

此规则强制执行一种编码风格，其中在 var、let 或 const 语句后需要或禁止使用空行，以在整个项目中实现一致的编码风格。

选项

此规则具有一个字符串选项

"always"（默认）要求在 var、let 或 const 后使用空行

var 语句后直接一行上的注释被视为附加的 var 语句。
"never" 不允许在 var、let 或 const 后使用空行

always

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

在 Playground 中打开

/*eslint newline-after-var: ["error", "always"]*/

var greet = "hello,",
    name = "world";
console.log(greet, name);

let hello = "hello,",
    world = "world";
console.log(hello, world);

var greet = "hello,";
const NAME = "world";
console.log(greet, NAME);

var greet = "hello,";
var name = "world";
// var name = require("world");
console.log(greet, name);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

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

在 Playground 中打开

/*eslint newline-after-var: ["error", "always"]*/

var greet = "hello,",
    name = "world";

console.log(greet, name);

let hello = "hello,",
    world = "world";

console.log(hello, world);

var greet = "hello,";
const NAME = "world";

console.log(greet, NAME);

var greet = "hello,";
var name = "world";
// var name = require("world");

console.log(greet, name);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

never

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

在 Playground 中打开

/*eslint newline-after-var: ["error", "never"]*/

var greet = "hello,",
    name = "world";

console.log(greet, name);

let hello = "hello,",
    world = "world";

console.log(hello, world);

var greet = "hello,";
const NAME = "world";

console.log(greet, NAME);

var greet = "hello,";
var name = "world";
// var name = require("world");

console.log(greet, name);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

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

在 Playground 中打开

/*eslint newline-after-var: ["error", "never"]*/

var greet = "hello,",
    name = "world";
console.log(greet, name);

let hello = "hello,",
    world = "world";
console.log(hello, world);

var greet = "hello,";
const NAME = "world";
console.log(greet, NAME);

var greet = "hello,";
var name = "world";
// var name = require("world");
console.log(greet, name);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

版本

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

资源

编辑此页面