Requires or disallows a whitespace (space or tab) beginning a comment (spaced-comment)

要求或禁止在注释前有空白 (space 或 tab) (spaced-comment)

The --fix option on the command line can automatically fix some of the problems reported by this rule.

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

Some style guides require or disallow a whitespace immediately after the initial // or /* of a comment.

一些风格指南要求或禁止注释 // 或 /* 后的空白。

Whitespace after the // or /* makes it easier to read text in comments. On the other hand, commenting out code is easier without having to put a whitespace right after the // or /*.

// 或 /* 后的空白使注释中的文本更容易阅读。另一方面，// 或 /* 后面不加空白的话，给代码添加注释会变得更容易。

Rule Details

This rule will enforce consistency of spacing after the start of a comment // or /*. It also provides several exceptions for various documentation styles.

该规则强制注释中 // 或 /* 后空格的一致性。它还为各种文档风格提供了一些例外情况。

Options

The rule takes two options.

该规则有两个可选项。

The first is a string which be either "always" or "never". The default is "always".
第一个是个字符串，值为 "always" 或 "never"。默认是 "always"。
- If "always" then the // or /* must be followed by at least one whitespace.
- 如果是 "always"，// 或 /* 必须跟随至少一个空白。
- If "never" then there should be no whitespace following.
- 如果是 "never"，其后不允许有空白。
This rule can also take a 2nd option, an object with any of the following keys: "exceptions" and "markers".
该规则可以设置第二个选项，是一个对象，其属性的键为 "exceptions" 和 "markers"。
- The "exceptions" value is an array of string patterns which are considered exceptions to the rule. Please note that exceptions are ignored if the first argument is "never".
- "exceptions" 的值是一个字符串形式的数组，这些字符串也就是该规则的例外。请注意，如果第一个参数是 "never"，例外情况会被忽略。
```
  "spaced-comment": ["error", "always", { "exceptions": ["-", "+"] }]
```
- The "markers" value is an array of string patterns which are considered markers for docblock-style comments, such as an additional /, used to denote documentation read by doxygen, vsdoc, etc. which must have additional characters. The "markers" array will apply regardless of the value of the first argument, e.g. "always" or "never".
- "markers"的值是一个字符串形式的数组，这些字符串也就是块级注释的标记，例如一个额外的 /，被用来表示是由 doxygen、vsdoc 等系统读取的文档，这些系统必须有额外的字符。不管第一个参数是 "always" 还是 "never"、"markers"数组都会起作用。
```
  "spaced-comment": ["error", "always", { "markers": ["/"] }]
```

The difference between a marker and an exception is that a marker only appears at the beginning of the comment whereas exceptions can occur anywhere in the comment string.

标记和例外的区别是，标记值只出现在注释的开头，而例外是可以出现在注释中任何地方。

You can also define separate exceptions and markers for block and line comments. The "block" object can have an additional key "balanced", a boolean that specifies if inline block comments should have balanced spacing. The default value is false.

你可以为块级注释和单行注释定义不同的例外和标记。"block" 对象可以有一个 boolean 类型的属性 "balanced"，用来指定内联块注释是否应该有对称的空格。默认为 false。

If "balanced": true and "always" then the /* must be followed by at least one whitespace, and the */ must be preceded by at least one whitespace.
如果 "balanced": true 而且是 "always" 那么 /* 后必须有只上一个空白，*/之前必须至少有一个空白。
If "balanced": true and "never" then there should be no whitespace following /* or preceding */.
如果 "balanced": true 而且是 "never" 那么 /* 之后或 */ 之前不应该有空白。
If "balanced": false then balanced whitespace is not enforced.
如果 "balanced": false 不强制有对称的空白。

"spaced-comment": ["error", "always", {
    "line": {
        "markers": ["/"],
        "exceptions": ["-", "+"]
    },
    "block": {
        "markers": ["!"],
        "exceptions": ["*"],
        "balanced": true
    }
}]

always

Examples of incorrect code for this rule with the "always" option:

选项 "always" 的错误代码示例：

/*eslint spaced-comment: ["error", "always"]*/

//This is a comment with no whitespace at the beginning

/*This is a comment with no whitespace at the beginning */

/* eslint spaced-comment: ["error", "always", { "block": { "balanced": true } }] */
/* This is a comment with whitespace at the beginning but not the end*/

Examples of correct code for this rule with the "always" option:

选项 "always" 的正确代码示例：

/* eslint spaced-comment: ["error", "always"] */

// This is a comment with a whitespace at the beginning

/* This is a comment with a whitespace at the beginning */

/*
 * This is a comment with a whitespace at the beginning
 */

/*
This comment has a newline
*/

/* eslint spaced-comment: ["error", "always"] */

/**
* I am jsdoc
*/

never

Examples of incorrect code for this rule with the "never" option:

选项 "never" 的错误代码示例：

/*eslint spaced-comment: ["error", "never"]*/

// This is a comment with a whitespace at the beginning

/* This is a comment with a whitespace at the beginning */

/* \nThis is a comment with a whitespace at the beginning */

/*eslint spaced-comment: ["error", "never", { "block": { "balanced": true } }]*/
/*This is a comment with whitespace at the end */

Examples of correct code for this rule with the "never" option:

选项 "never" 的正确代码示例：

/*eslint spaced-comment: ["error", "never"]*/

/*This is a comment with no whitespace at the beginning */

/*eslint spaced-comment: ["error", "never"]*/

/**
* I am jsdoc
*/

exceptions

Examples of incorrect code for this rule with the "always" option combined with "exceptions":

选项 "always" 结合 "exceptions" 的错误代码示例：

/* eslint spaced-comment: ["error", "always", { "block": { "exceptions": ["-"] } }] */

//--------------
// Comment block
//--------------

/* eslint spaced-comment: ["error", "always", { "exceptions": ["-", "+"] }] */

//------++++++++
// Comment block
//------++++++++

/* eslint spaced-comment: ["error", "always", { "exceptions": ["-", "+"] }] */

/*------++++++++*/
/* Comment block */
/*------++++++++*/

/* eslint spaced-comment: ["error", "always", { "line": { "exceptions": ["-+"] } }] */

/*-+-+-+-+-+-+-+*/
// Comment block
/*-+-+-+-+-+-+-+*/

Examples of correct code for this rule with the "always" option combined with "exceptions":

选项 "always" 结合 "exceptions" 的正确代码示例：

/* eslint spaced-comment: ["error", "always", { "exceptions": ["-"] }] */

//--------------
// Comment block
//--------------

/* eslint spaced-comment: ["error", "always", { "line": { "exceptions": ["-"] } }] */

//--------------
// Comment block
//--------------

/* eslint spaced-comment: ["error", "always", { "exceptions": ["*"] }] */

/****************
 * Comment block
 ****************/

/* eslint spaced-comment: ["error", "always", { "exceptions": ["-+"] }] */

//-+-+-+-+-+-+-+
// Comment block
//-+-+-+-+-+-+-+

/*-+-+-+-+-+-+-+*/
// Comment block
/*-+-+-+-+-+-+-+*/

/* eslint spaced-comment: ["error", "always", { "block": { "exceptions": ["-+"] } }] */

/*-+-+-+-+-+-+-+*/
// Comment block
/*-+-+-+-+-+-+-+*/

markers

Examples of incorrect code for this rule with the "always" option combined with "markers":

选项 "always" 结合 "markers" 的错误代码示例：

/* eslint spaced-comment: ["error", "always", { "markers": ["/"] }] */

///This is a comment with a marker but without whitespace

/*eslint spaced-comment: ["error", "always", { "block": { "markers": ["!"], "balanced": true } }]*/
/*! This is a comment with a marker but without whitespace at the end*/

/*eslint spaced-comment: ["error", "never", { "block": { "markers": ["!"], "balanced": true } }]*/
/*!This is a comment with a marker but with whitespace at the end */

Examples of correct code for this rule with the "always" option combined with "markers":

选项 "always" 结合 "markers" 的正确代码示例：

/* eslint spaced-comment: ["error", "always", { "markers": ["/"] }] */

/// This is a comment with a marker

/*eslint spaced-comment: ["error", "never", { "markers": ["!<"] }]*/

//!<This is a line comment with a marker

/*!<this is a block comment with a marker
subsequent lines are ignored
*/

/* eslint spaced-comment: ["error", "always", { "markers": ["global"] }] */

/*global ABC*/

spaced-line-comment

Version

This rule was introduced in ESLint 0.23.0.

该规则在 ESLint 0.23.0 中被引入。