multiline-comment-style

强制执行多行注释的特定样式

🔧

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

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

许多样式指南要求对跨越多行的注释使用特定的样式。例如，一些样式指南更喜欢对多行注释使用单个块注释，而其他样式指南更喜欢连续的行注释。

规则详细信息

此规则旨在强制执行多行注释的特定样式。

选项

此规则具有一个字符串选项，该选项可以具有以下值之一

"starred-block"（默认）：禁止连续的行注释，而赞成块注释。此外，要求块注释在每一行之前都有一个对齐的 * 字符。
"bare-block"：禁止连续的行注释，而赞成块注释，并且禁止块注释在每一行之前都有 "*" 字符。此选项会忽略 JSDoc 注释。
"separate-lines"：禁止块注释，而赞成连续的行注释。默认情况下，此选项会忽略 JSDoc 注释。要将此规则也应用于 JSDoc 注释，请将 checkJSDoc 选项设置为 true。

该规则始终会忽略指令注释，例如 /* eslint-disable */。

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

在游乐场中打开


/* eslint multiline-comment-style: ["error", "starred-block"] */

// this line
// calls foo()
foo();

/* this line
calls foo() */
foo();

/* this comment
 * is missing a newline after /*
 */

/*
 * this comment
 * is missing a newline at the end */

/*
* the star in this line should have a space before it
 */

/*
 * the star on the following line should have a space before it
*/

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

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

在游乐场中打开

/* eslint multiline-comment-style: ["error", "starred-block"] */

/*
 * this line
 * calls foo()
 */
foo();

// single-line comment
1
2
3
4
5
6
7
8
9

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

在游乐场中打开

/* eslint multiline-comment-style: ["error", "bare-block"] */

// this line
// calls foo()
foo();

/*
 * this line
 * calls foo()
 */
foo();
1
2
3
4
5
6
7
8
9
10
11

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

在游乐场中打开

/* eslint multiline-comment-style: ["error", "bare-block"] */

/* this line
   calls foo() */
foo();
1
2
3
4
5

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

在游乐场中打开


/* eslint multiline-comment-style: ["error", "separate-lines"] */

/* This line
calls foo() */
foo();

/*
 * This line
 * calls foo()
 */
foo();

1
2
3
4
5
6
7
8
9
10
11
12
13

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

在游乐场中打开

/* eslint multiline-comment-style: ["error", "separate-lines"] */

// This line
// calls foo()
foo();

1
2
3
4
5
6

使用 "separate-lines" 选项并将 checkJSDoc 设置为 true 时，此规则的错误代码示例

在游乐场中打开


/* eslint multiline-comment-style: ["error", "separate-lines", { "checkJSDoc": true }] */

/**
 * I am a JSDoc comment
 * and I'm not allowed
 */
foo();

1
2
3
4
5
6
7
8
9

使用 "separate-lines" 选项并将 checkJSDoc 设置为 true 时，此规则的正确代码示例

在游乐场中打开

/* eslint multiline-comment-style: ["error", "separate-lines", { "checkJSDoc": true }] */

// I am a JSDoc comment
// and I'm not allowed
foo();

1
2
3
4
5
6

何时不使用它

如果您不想强制执行多行注释的特定样式，则可以禁用该规则。

版本

此规则是在 ESLint v4.10.0 中引入的。

资源

编辑此页面