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" 选项时，此规则的 **不正确** 代码示例

在游乐场中打开

/*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" 选项时，此规则的 **正确** 代码示例

在游乐场中打开

/*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" 选项时，此规则的 **不正确** 代码示例

在游乐场中打开

/*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" 选项时，此规则的 **正确** 代码示例

在游乐场中打开

/*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 中引入的。

资源

编辑此页面