规则参考

ESLint 中的规则按类型分组，以帮助你了解它们的用途。每条规则都有表情符号表示：

¥Rules in ESLint are grouped by type to help you understand their purpose. Each rule has emojis denoting:

✅

在 配置文件 中使用来自 @eslint/js 的 recommended 配置可以启用此规则

🔧

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

💡

此规则报告的一些问题可通过编辑器建议手动修复

可能的问题

这些规则与代码中可能出现的逻辑错误有关：

array-callback-return

在数组方法的回调中强制执行 return 语句

💡

constructor-super

要求在构造函数中调用 super()

✅

for-direction

强制 for 循环更新子句将计数器移向正确方向

✅

getter-return

在 getter 中执行 return 语句

✅

no-async-promise-executor

禁止使用异步函数作为 Promise 执行器

✅

no-await-in-loop

禁止 await 进入循环

no-class-assign

禁止重新分配类成员

✅

no-compare-neg-zero

禁止与 -0 进行比较

✅

no-cond-assign

禁止条件表达式中的赋值运算符

✅

no-const-assign

禁止重新分配 const 变量

✅

no-constant-condition

禁止在条件中使用常量表达式

✅

no-constructor-return

不允许从构造函数返回值

no-control-regex

禁止在正则表达式中使用控制字符

✅

no-debugger

禁止使用 debugger

✅

no-dupe-args

禁止 function 定义中的重复参数

✅

no-dupe-else-if

禁止 if-else-if 链中的重复条件

✅

no-dupe-keys

禁止对象字面量中的重复键

✅

no-duplicate-case

不允许重复的案例标签

✅

no-empty-character-class

禁止在正则表达式中使用空字符类

✅

no-empty-pattern

不允许空解构模式

✅

no-ex-assign

禁止在 catch 条款中重新分配例外情况

✅

no-fallthrough

禁止 case 语句的失败

✅

no-func-assign

禁止重新分配 function 声明

✅

no-import-assign

禁止分配给导入的绑定

✅

no-inner-declarations

禁止在嵌套块中声明变量或 function

no-invalid-regexp

禁止在 RegExp 构造函数中使用无效的正则表达式字符串

✅

no-loss-of-precision

不允许失去精度的字面数字

✅

no-misleading-character-class

不允许在字符类语法中使用多个代码点组成的字符

✅

💡

no-obj-calls

不允许将全局对象属性作为函数调用

✅

no-prototype-builtins

禁止直接在对象上调用某些 Object.prototype 方法

✅

💡

no-self-assign

禁止双方完全相同的分配

✅

no-self-compare

禁止双方完全相同的比较

no-setter-return

禁止从 setter 返回值

✅

no-sparse-arrays

不允许稀疏数组

✅

no-template-curly-in-string

禁止在常规字符串中使用模板字面占位符语法

no-this-before-super

在构造函数中调用 super() 之前禁止 this/super

✅

no-undef

禁止使用未声明的变量，除非在 /*global */ 注释中提及

✅

no-unreachable

禁止在 return、throw、continue 和 break 语句后出现无法访问的代码

✅

no-unreachable-loop

不允许循环体只允许一次迭代

no-unsafe-finally

禁止 finally 块中的控制流语句

✅

no-unsafe-negation

不允许否定关系运算符的左操作数

✅

💡

no-unsafe-optional-chaining

不允许在不允许 undefined 值的上下文中使用可选链接

✅

no-unused-vars

禁止未使用的变量

✅

💡

no-use-before-define

禁止在定义变量之前使用变量

no-useless-assignment

不使用值时禁止变量赋值

no-useless-backreference

禁止在正则表达式中使用无用的反向引用

✅

require-atomic-updates

禁止因使用 await 或 yield 而导致竞争条件的分配

use-isnan

检查 NaN 时需要调用 isNaN()

✅

💡

valid-typeof

强制将 typeof 表达式与有效字符串进行比较

✅

💡

建议

这些规则建议了替代的使用方式：

accessor-pairs

在对象和类中强制执行 getter 和 setter 对

arrow-body-style

箭头函数体周围需要大括号

🔧

block-scoped-var

在定义的范围内强制使用变量

camelcase

强制执行驼峰命名约定

capitalized-comments

强制或禁止注释首字母大写

🔧

complexity

强制执行程序中允许的最大圈复杂度

consistent-return

要求 return 语句始终或从不指定值

consistent-this

在捕获当前执行上下文时强制执行一致的命名

curly

对所有控制语句强制执行一致的大括号样式

🔧

default-case

在 switch 语句中要求 default 个案例

default-case-last

强制 switch 语句中的 default 子句为最后子句

default-param-last

强制默认参数在最后

dot-notation

尽可能使用点符号

🔧

eqeqeq

要求使用 === 和 !==

🔧

func-name-matching

要求函数名称与分配给它们的变量或属性的名称相匹配

func-names

要求或禁止命名的 function 表达式

func-style

强制一致使用 function 声明或分配给变量的表达式

grouped-accessor-pairs

要求对象字面量和类中的分组访问器对

guard-for-in

要求 for-in 循环包含 if 语句

id-denylist

不允许指定的标识符

id-length

强制执行最小和最大标识符长度

id-match

要求标识符匹配指定的正则表达式

init-declarations

要求或禁止在变量声明中进行初始化

max-classes-per-file

强制每个文件的最大类数

max-depth

强制执行块可以嵌套的最大深度

max-lines

强制每个文件的最大行数

max-lines-per-function

在函数中强制执行最大代码行数

max-nested-callbacks

强制执行回调可以嵌套的最大深度

max-params

在函数定义中强制执行最大数量的参数

max-statements

强制执行功能块中允许的最大语句数

new-cap

要求构造函数名称以大写字母开头

no-alert

禁止使用 alert、confirm 和 prompt

no-bitwise

禁止按位运算符

no-caller

禁止使用 arguments.caller 或 arguments.callee

no-case-declarations

不允许在 case 子句中进行词法声明

✅

💡

no-console

禁止使用 console

💡

no-continue

禁止 continue 语句

no-delete-var

不允许删除变量

✅

no-div-regex

在正则表达式的开头明确禁止等号

🔧

no-else-return

禁止 if 语句中的 return 语句之后的 else 块

🔧

no-empty

不允许空块语句

✅

💡

no-empty-function

不允许空函数

no-eq-null

禁止在没有类型检查运算符的情况下进行 null 比较

no-eval

禁止使用 eval()

no-extend-native

禁止扩展原生类型

no-extra-bind

禁止对 .bind() 进行不必要的调用

🔧

no-extra-label

禁止不必要的标签

🔧

no-global-assign

不允许分配给原生对象或只读全局变量

✅

no-implicit-globals

不允许在全局作用域内声明

no-implied-eval

禁止使用类似 eval() 的方法

no-inline-comments

禁止代码后的内联注释

no-invalid-this

禁止在 this 的值为 undefined 的上下文中使用 this

no-iterator

禁止使用 __iterator__ 属性

no-label-var

禁止与变量共享名称的标签

no-labels

禁止标记语句

no-lone-blocks

禁止不必要的嵌套块

no-lonely-if

不允许 if 语句作为 else 块中的唯一语句

🔧

no-loop-func

禁止在循环语句中包含不安全引用的函数声明

no-magic-numbers

禁止幻数

no-multi-assign

禁止使用链式赋值表达式

no-multi-str

禁止多行字符串

no-nested-ternary

禁止嵌套的三元表达式

no-new

禁止在赋值或比较之外使用 new 运算符

no-new-func

禁止使用 Function 对象的 new 运算符

no-new-wrappers

禁止对 String、Number 和 Boolean 对象使用 new 运算符

no-nonoctal-decimal-escape

禁止在字符串字面中使用 \8 和 \9 转义序列

✅

💡

no-object-constructor

禁止调用不带参数的 Object 构造函数

💡

no-octal

禁止八进制字面

✅

no-octal-escape

禁止在字符串字面中使用八进制转义序列

no-param-reassign

禁止重新分配函数参数

no-plusplus

禁止使用一元运算符 ++ 和 --

no-proto

禁止使用 __proto__ 属性

no-redeclare

不允许变量重新声明

✅

no-regex-spaces

禁止在正则表达式中使用多个空格

✅

🔧

no-restricted-imports

import 加载时禁止指定模块

no-return-assign

禁止在 return 语句中使用赋值运算符

no-script-url

禁止 javascript: URL

no-sequences

禁止逗号运算符

no-shadow

禁止在外部作用域中声明的隐藏变量的变量声明

no-ternary

禁止三元运算符

no-throw-literal

不允许将字面作为异常抛出

no-undef-init

不允许将变量初始化为 undefined

🔧

no-undefined

禁止使用 undefined 作为标识符

no-underscore-dangle

不允许在标识符中使用悬挂下划线

no-unneeded-ternary

当存在更简单的替代方案时，禁止使用三元运算符

🔧

no-unused-labels

禁止未使用的标签

✅

🔧

no-useless-call

禁止对 .call() 和 .apply() 进行不必要的调用

no-useless-catch

禁止不必要的 catch 条款

✅

no-useless-computed-key

禁止在对象和类中使用不必要的计算属性键

🔧

no-useless-concat

禁止不必要的字面或模板字面串联

no-useless-escape

禁止不必要的转义字符

✅

💡

no-useless-rename

不允许将导入、导出和解构的分配重命名为相同的名称

🔧

no-useless-return

禁止冗余返回语句

🔧

no-var

需要 let 或 const 而不是 var

🔧

no-void

禁止 void 运算符

no-warning-comments

不允许在注释中指定警告条款

no-with

禁止 with 语句

✅

object-shorthand

要求或禁止对象字面的方法和属性速记语法

🔧

one-var

强制变量在函数中一起或单独声明

🔧

operator-assignment

尽可能要求或禁止赋值运算符简写

🔧

prefer-arrow-callback

需要使用箭头函数进行回调

🔧

prefer-const

声明后永远不会重新分配的变量需要 const 声明

🔧

prefer-destructuring

需要从数组和/或对象中解构

🔧

prefer-numeric-literals

不允许 parseInt() 和 Number.parseInt() 支持二进制、八进制和十六进制字面

🔧

prefer-object-has-own

不允许使用 Object.prototype.hasOwnProperty.call()，更喜欢使用 Object.hasOwn()

🔧

prefer-object-spread

禁止使用 Object.assign 和对象字面量作为第一个参数，而应使用对象扩展

🔧

prefer-regex-literals

禁止使用 RegExp 构造函数以支持正则表达式字面

💡

prefer-rest-params

需要 rest 参数而不是 arguments

prefer-spread

需要扩展运算符而不是 .apply()

prefer-template

需要模板字面而不是字符串连接

🔧

radix

使用 parseInt() 时强制一致使用基数参数

💡

require-await

禁止没有 await 表达式的异步函数

💡

require-unicode-regexp

强制在正则表达式上使用 u 或 v 标志

💡

require-yield

要求生成器函数包含 yield

✅

sort-imports

在模块中强制执行排序的导入声明

🔧

sort-keys

要求对对象键进行排序

sort-vars

要求对同一声明块中的变量进行排序

🔧

strict

要求或禁止严格模式指令

🔧

vars-on-top

要求 var 声明放在其包含范围的顶部

yoda

要求或禁止 “Yoda” 条件

🔧

布局和格式

这些规则关心的是代码的外观而不是它的执行方式：

unicode-bom

要求或禁止 Unicode 字节顺序标记 (BOM)

🔧

已弃用

根据 弃用政策，这些规则已被弃用，并被新规则取代：

array-bracket-newline 已弃用

❌

🔧

array-bracket-spacing 已弃用

❌

🔧

array-element-newline 已弃用

❌

🔧

arrow-parens 已弃用

❌

🔧

arrow-spacing 已弃用

❌

🔧

block-spacing 已弃用

❌

🔧

brace-style 已弃用

❌

🔧

callback-return 已弃用

❌

comma-dangle 已弃用

❌

🔧

comma-spacing 已弃用

❌

🔧

comma-style 已弃用

❌

🔧

computed-property-spacing 已弃用

❌

🔧

dot-location 已弃用

❌

🔧

eol-last 已弃用

❌

🔧

func-call-spacing 已弃用

❌

🔧

function-call-argument-newline 已弃用

❌

🔧

function-paren-newline 已弃用

❌

🔧

generator-star-spacing 已弃用

❌

🔧

global-require 已弃用

❌

handle-callback-err 已弃用

❌

id-blacklist 已弃用

替换为 id-denylist

❌

implicit-arrow-linebreak 已弃用

❌

🔧

indent 已弃用

❌

🔧

indent-legacy 已弃用

替换为 indent

❌

🔧

jsx-quotes 已弃用

❌

🔧

key-spacing 已弃用

❌

🔧

keyword-spacing 已弃用

❌

🔧

line-comment-position 已弃用

❌

linebreak-style 已弃用

❌

🔧

lines-around-comment 已弃用

❌

🔧

lines-between-class-members 已弃用

❌

🔧

max-len 已弃用

❌

max-statements-per-line 已弃用

❌

multiline-comment-style 已弃用

❌

🔧

multiline-ternary 已弃用

❌

🔧

new-parens 已弃用

❌

🔧

newline-per-chained-call 已弃用

❌

🔧

no-buffer-constructor 已弃用

❌

no-catch-shadow 已弃用

替换为 no-shadow

❌

no-confusing-arrow 已弃用

❌

🔧

no-extra-parens 已弃用

❌

🔧

no-extra-semi 已弃用

❌

🔧

no-floating-decimal 已弃用

❌

🔧

no-mixed-operators 已弃用

❌

no-mixed-requires 已弃用

❌

no-mixed-spaces-and-tabs 已弃用

❌

no-multi-spaces 已弃用

❌

🔧

no-multiple-empty-lines 已弃用

❌

🔧

no-native-reassign 已弃用

替换为 no-global-assign

❌

no-negated-in-lhs 已弃用

替换为 no-unsafe-negation

❌

no-new-require 已弃用

❌

no-path-concat 已弃用

❌

no-process-env 已弃用

❌

no-process-exit 已弃用

❌

no-restricted-modules 已弃用

❌

no-return-await 已弃用

❌

💡

no-spaced-func 已弃用

替换为 func-call-spacing

❌

🔧

no-sync 已弃用

❌

no-tabs 已弃用

❌

no-trailing-spaces 已弃用

❌

🔧

no-whitespace-before-property 已弃用

❌

🔧

nonblock-statement-body-position 已弃用

❌

🔧

object-curly-newline 已弃用

❌

🔧

object-curly-spacing 已弃用

❌

🔧

object-property-newline 已弃用

❌

🔧

one-var-declaration-per-line 已弃用

❌

🔧

operator-linebreak 已弃用

❌

🔧

padded-blocks 已弃用

❌

🔧

padding-line-between-statements 已弃用

❌

🔧

prefer-reflect 已弃用

❌

quote-props 已弃用

❌

🔧

quotes 已弃用

❌

🔧

rest-spread-spacing 已弃用

❌

🔧

semi 已弃用

❌

🔧

semi-spacing 已弃用

❌

🔧

semi-style 已弃用

❌

🔧

space-before-blocks 已弃用

❌

🔧

space-before-function-paren 已弃用

❌

🔧

space-in-parens 已弃用

❌

🔧

space-infix-ops 已弃用

❌

🔧

space-unary-ops 已弃用

❌

🔧

spaced-comment 已弃用

❌

🔧

switch-colon-spacing 已弃用

❌

🔧

template-curly-spacing 已弃用

❌

🔧

template-tag-spacing 已弃用

❌

🔧

wrap-iife 已弃用

❌

🔧

wrap-regex 已弃用

❌

🔧

yield-star-spacing 已弃用

❌

🔧

已删除

旧版本 ESLint（在 弃用政策 存在之前）中的这些规则已被新规则取代：

global-strict 已移除

替换为 strict

no-empty-label 已移除

替换为 no-labels

no-extra-strict 已移除

替换为 strict

valid-jsdoc 已移除

替换为

require-jsdoc 已移除

替换为

ESLint 中文网
粤ICP备13048890号