规则

以下是 Biome 支持的规则列表，按组划分。以下是表情符号的图例：

¥Below the list of rules supported by Biome, divided by group. Here’s a legend of the emojis:

图标表示该规则是推荐规则的一部分。

¥The icon indicates that the rule is part of the recommended rules.
图标表示该规则提供了可以安全应用的代码操作（修复）。

¥The icon indicates that the rule provides a code action (fix) that is safe to apply.
图标表示该规则提供了不安全应用的代码操作（修复）。

¥The icon indicates that the rule provides a code action (fix) that is unsafe to apply.
图标表示该规则适用于 JavaScript 和超级语言文件。

¥The icon indicates that the rule is applied to JavaScript and super languages files.
图标表示该规则适用于 TypeScript 和 TSX 文件。

¥The icon indicates that the rule is applied to TypeScript and TSX files.
图标表示该规则适用于 JSON 文件。

¥The icon indicates that the rule is applied to JSON files.
图标表示该规则已应用于 CSS 文件。

¥The icon indicates that the rule is applied to CSS files.
图标表示该规则适用于 GraphQL 文件。

¥The icon indicates that the rule is applied to GraphQL files.

可访问性

¥Accessibility

规则侧重于防止可访问性问题。

¥Rules focused on preventing accessibility problems.

规则名称	描述	属性
noAccessKey	强制不在任何 HTML 元素上使用该属性。
noAriaHiddenOnFocusable	强制可聚焦元素上未设置 aria-hidden=“true”。
noAriaUnsupportedElements	强制不支持 ARIA 角色、状态和属性的元素不具有这些属性。
noAutofocus	强制元素上未使用 autoFocus prop。
noBlankTarget	禁止使用属性
noDistractingElements	强制不使用分散注意力的元素。
noHeaderScope	scope prop 应该只用于元素。
noInteractiveElementToNoninteractiveRole	强制不将非交互式 ARIA 角色分配给交互式 HTML 元素。
noLabelWithoutControl	强制标签元素或组件具有文本标签和相关输入。
noNoninteractiveElementToInteractiveRole	强制不将交互式 ARIA 角色分配给非交互式 HTML 元素。
noNoninteractiveTabindex	强制未分配给非交互式 HTML 元素。
noPositiveTabindex	防止在属性上使用正整数
noRedundantAlt	强制 alt 属性不包含单词 “image”、“picture” 或 “photo”。
noRedundantRoles	强制显式属性与元素上的隐式/默认角色属性不同。
noSvgWithoutTitle	强制元素使用元素。
useAltText	强制所有需要替代文本的元素都具有有意义的信息以传递回终端用户。
useAnchorContent	强制锚点具有内容，并且内容可供屏幕阅读器访问。
useAriaActivedescendantWithTabindex	强制使用分配给非交互式 HTML 元素。
useAriaPropsForRole	强制具有 ARIA 角色的元素必须具有该角色所需的所有 ARIA 属性。
useButtonType	强制元素使用属性
useFocusableInteractive	具有交互角色和交互处理程序的元素必须是可聚焦的。
useGenericFontNames	禁止在字体系列中缺少通用系列关键字。
useHeadingContent	强制标题元素（h1、h2 等）具有内容，并且内容可供屏幕阅读器访问。可访问意味着它不会使用 aria-hidden 属性隐藏。
useHtmlLang	强制元素具有属性。
useIframeTitle	强制元素使用属性。
useKeyWithClickEvents	强制整个代码库的所有内容的命名约定。, , .
useKeyWithMouseEvents	强制 / 伴随 / 。
useMediaCaption	强制元素必须具有标题。
useSemanticElements	它检测 JSX 元素中属性的使用情况并建议改用语义元素。
useValidAnchor	强制所有锚点有效，并且它们是可导航元素。
useValidAriaProps	确保 ARIA 属性全部有效。
useValidAriaRole	具有 ARIA 角色的元素必须使用有效的非抽象 ARIA 角色。
useValidAriaValues	强制正确使用和。
useValidLang	确保传递给属性的属性是正确的 ISO 语言和/或国家/地区。

复杂性

¥Complexity

侧重于检查可以简化的复杂代码的规则。

¥Rules that focus on inspecting complex code that could be simplified.

规则名称	描述	属性
noBannedTypes	禁止原始类型别名和误导性类型。
noEmptyTypeParameters	禁止类型别名和接口中的空类型参数。
noExcessiveCognitiveComplexity	禁止超过给定认知复杂性分数的函数。
noExcessiveNestedTestSuites	此规则强制测试文件中嵌套的最大深度。
noExtraBooleanCast	禁止不必要的布尔转换
noForEach	优先使用语句而不是。
noMultipleSpacesInRegularExpressionLiterals	禁止在正则表达式文字中不明确地使用连续空格字符
noStaticOnlyClass	此规则报告类没有非静态成员的情况，例如专门用作静态命名空间的类。
noThisInStatic	禁止上下文中的和。
noUselessCatch	禁止不必要的子句。
noUselessConstructor	禁止不必要的构造函数。
noUselessEmptyExport	禁止在模块文件中不更改任何内容的空导出。
noUselessFragments	禁止不必要的片段
noUselessLabel	禁止不必要的标签。
noUselessLoneBlockStatements	禁止不必要的嵌套块语句。
noUselessRename	禁止将导入、导出和解构分配重命名为同一名称。
noUselessStringConcat	禁止不必要的字符串或模板文字连接。
noUselessSwitchCase	禁止在语句中使用无用内容。
noUselessTernary	当存在更简单的替代方案时，禁止使用三元运算符。
noUselessThisAlias	禁止无用的别名。
noUselessTypeConstraint	禁止使用或作为类型约束。
noUselessUndefinedInitialization	禁止将变量初始化为。
noVoid	禁止使用运算符，这不是一个熟悉的运算符。
noWith	禁止非严格上下文中的语句。
useArrowFunction	在函数表达式上使用箭头函数。
useDateNow	用于获取自 Unix 纪元以来的毫秒数。
useFlatMap	提倡使用 when 一起使用。
useLiteralKeys	强制使用文字访问属性而不是计算属性访问。
useOptionalChain	强制使用简洁的可选链而不是链式逻辑表达式。
useRegexLiterals	如果可能，强制使用正则表达式文字而不是 RegExp 构造函数。
useSimpleNumberKeys	禁止非十进制或使用下划线作为分隔符的数字文字对象成员名称
useSimplifiedLogicExpression	从逻辑表达式中丢弃冗余术语。

正确性

¥Correctness

检测肯定不正确或无用的代码的规则。

¥Rules that detect code that is guaranteed to be incorrect or useless.

规则名称	描述	属性
noChildrenProp	防止将子组件作为 props 传递。
noConstAssign	防止重新分配变量。
noConstantCondition	禁止在条件中使用常量表达式
noConstantMathMinMaxClamp	禁止使用和来限制结果本身为常数的值。
noConstructorReturn	禁止从返回值。
noEmptyCharacterClassInRegex	禁止正则表达式文字中的空字符类。
noEmptyPattern	禁止空的解构模式。
noFlatMapIdentity	禁止在上使用不必要的回调。
noGlobalObjectCalls	禁止将全局对象属性作为函数调用
noInnerDeclarations	禁止可在其块外访问的和声明。
noInvalidBuiltinInstantiation	确保内置函数正确实例化。
noInvalidConstructorSuper	防止错误使用内部类。它还检查扩展其他构造函数的类中是否缺少调用。
noInvalidDirectionInLinearGradient	禁止线性梯度函数使用非标准方向值。
noInvalidGridAreas	禁止在 CSS 网格布局中无效命名的网格区域。
noInvalidNewBuiltin	禁止具有全局非构造函数的运算符。
noInvalidPositionAtImportRule	禁止在无效位置使用 @ 规则。
noInvalidUseBeforeDeclaration	禁止在声明之前使用变量和函数参数
noNewSymbol	禁止带有对象的运算符。
noNodejsModules	禁止使用 Node.js 内置模块。
noNonoctalDecimalEscape	禁止字符串文字中的和转义序列。
noPrecisionLoss	禁止丢失精度的文字数字
noRenderReturnValue	防止使用的返回值。
noSelfAssign	禁止在双方完全相同的情况下进行分配。
noSetterReturn	禁止从 setter 返回值
noStringCaseMismatch	禁止比较使用不合规值修改字符串大小写的表达式。
noSwitchDeclarations	禁止在子句中使用词汇声明。
noUndeclaredDependencies	禁止使用未在中指定的依赖。
noUndeclaredVariables	防止使用文档中未声明的变量。
noUnknownFunction	禁止未知的 CSS 值函数。
noUnknownMediaFeatureName	禁止未知的媒体功能名称。
noUnknownProperty	禁止未知的属性。
noUnknownUnit	禁止未知的 CSS 单位。
noUnmatchableAnbSelector	禁止不匹配的 An+B 选择器。
noUnnecessaryContinue	避免使用不必要的。
noUnreachable	禁止无法访问的代码
noUnreachableSuper	如果类具有超类，则确保在访问类构造函数之前，在类构造函数中的每个代码路径上都只调用一次构造函数
noUnsafeFinally	禁止在 finally 块中控制流语句。
noUnsafeOptionalChaining	禁止在未允许使用未定义值的上下文中使用可选链接。
noUnusedFunctionParameters	禁止未使用的函数参数。
noUnusedImports	禁止未使用的导入。
noUnusedLabels	禁止未使用的标签。
noUnusedPrivateClassMembers	禁止未使用的私有类成员
noUnusedVariables	禁止未使用的变量。
noVoidElementsWithChildren	此规则防止空元素（又称自关闭元素）有子元素。
noVoidTypeReturn	禁止从返回类型为 ‘void’ 的函数返回值
useArrayLiterals	禁止数组构造函数。
useExhaustiveDependencies	强制在 React hook 中正确指定所有依赖。
useHookAtTopLevel	强制所有 React 钩子都从顶层组件函数调用。
useImportExtensions	强制显式比较值的、、或属性。
useIsNan	检查时需要调用。
useJsxKeyInIterable	禁止在迭代器/集合文字中缺少关键属性。
useValidForDirection	强制 “for” 循环更新子句将计数器移向正确的方向。
useYield	要求生成器函数包含。

Nursery

仍在开发中的新规则。

Nursery 规则需要在稳定版本上通过配置明确选择加入，因为它们可能仍然存在错误或性能问题。
它们在夜间构建中默认启用，但由于它们不稳定，因此它们的诊断严重性可能设置为错误或
警告，具体取决于我们是否打算在规则最终稳定后推荐该规则。
Nursery 规则一旦稳定下来就会提升到其他组，否则可能会被删除。

属于此组的规则 are not subject to semantic version。

¥New rules that are still under development.

Nursery rules require explicit opt-in via configuration on stable versions because they may still have bugs or performance problems.
They are enabled by default on nightly builds, but as they are unstable their diagnostic severity may be set to either error or
warning, depending on whether we intend for the rule to be recommended or not when it eventually gets stabilized.
Nursery rules get promoted to other groups once they become stable or may be removed.

Rules that belong to this group are not subject to semantic version.

规则名称	描述	属性
noCommonJs	禁止使用 CommonJs 模块系统，转而使用 ESM 样式导入。
noDuplicateCustomProperties	禁止在声明块中重复自定义属性。
noDuplicateElseIf	禁止 if-else-if 链中的重复条件
noDuplicatedFields	GraphQL 操作中没有重复的字段。
noDynamicNamespaceImportAccess	禁止动态访问命名空间导入。
noEnum	禁止 TypeScript 枚举。
noExportedImports	禁止导出导入的变量。
noIrregularWhitespace	禁止使用不规则的空格字符。
noIrregularWhitespace	禁止使用不规则的空格字符。
noRestrictedImports	当通过 import 或 require 加载时，禁止指定模块。
noRestrictedTypes	禁止用户定义的类型。
noSecrets	禁止使用敏感数据，例如 API 密钥和令牌。
noStaticElementInteractions	强制具有点击处理程序的静态可见元素（例如）使用有效的角色属性。
noSubstr	强制使用 over 和。
noUnknownPseudoClass	禁止未知的伪类选择器。
noUnknownPseudoElement	禁止未知的伪元素选择器。
noUselessEscapeInRegex	禁止在正则表达式文字中使用不必要的转义序列。
noValueAtRule	禁止在 css 模块中使用规则。
useAdjacentOverloadSignatures	禁止使用不相邻的过载签名。
useAriaPropsSupportedByRole	强制 ARIA 属性对于元素支持的角色有效。
useConsistentCurlyBraces	此规则强制在 JSX 属性和 JSX 子项内一致使用大括号。
useConsistentMemberAccessibility	要求在类属性和方法上使用一致的可访问性修饰符。
useDeprecatedReason	要求在使用@deprecated 指令时指定原因参数
useImportRestrictions	不允许包私有导入。
useSortedClasses	强制对 CSS 实用程序类进行排序。
useStrictMode	强制在脚本文件中使用指令。
useTrimStartEnd	强制在和上使用和。
useValidAutocomplete	对元素上的属性使用有效值。

性能

¥Performance

规则捕捉可以编写代码以使其运行得更快或通常更高效的方法。

¥Rules catching ways your code could be written to run faster, or generally be more efficient.

规则名称	描述	属性
noAccumulatingSpread	禁止在累加器上使用 spread () 语法。
noBarrelFile	禁止使用 barrel 文件。
noDelete	禁止使用运算符。
noReExportAll	避免重新导出所有内容。
useTopLevelRegex	要求在顶层声明正则表达式文字。

安全性

¥Security

检测潜在安全漏洞的规则。

¥Rules that detect potential security flaws.

规则名称	描述	属性
noDangerouslySetInnerHtml	防止使用危险的 JSX props
noDangerouslySetInnerHtmlWithChildren	报告 DOM 元素或组件何时同时使用和 prop。
noGlobalEval	禁止使用全局的。

风格

¥Style

规则强制以一致且惯用的方式编写代码。

¥Rules enforcing a consistent and idiomatic way of writing your code.

规则名称	描述	属性
noArguments	禁止使用。
noCommaOperator	禁止逗号运算符。
noDefaultExport	禁止默认导出。
noDoneCallback	禁止在异步测试和钩子中使用回调。
noImplicitBoolean	禁止在 JSX 布尔属性上使用隐式值
noInferrableTypes	禁止使用文字表达式初始化的变量、参数和类属性的类型注释。
noNamespace	禁止使用 TypeScript 的 s。
noNamespaceImport	禁止使用命名空间导入。
noNegationElse	如果语句有子句，则禁止在语句的条件中使用否定。
noNonNullAssertion	禁止使用后缀运算符进行非空断言。
noParameterAssign	禁止重新分配参数。
noParameterProperties	禁止在类构造函数中使用参数属性。
noRestrictedGlobals	此规则允许你指定不想在应用中使用的全局变量名称。
noShoutyConstants	禁止使用其值为名称大写版本的常量。
noUnusedTemplateLiteral	如果不需要插值和特殊字符处理，则禁止使用模板文字
noUselessElse	当块提前中断时禁止块。
noVar	禁止使用
noYodaExpression	禁止使用 yoda 表达式。
useAsConstAssertion	强制使用 over 文字类型和类型注释。
useBlockStatements	要求遵循大括号约定。
useCollapsedElseIf	强制使用而不是嵌套子句。
useConsistentArrayType	要求一致使用或
useConsistentBuiltinInstantiation	强制所有内置函数（和除外）使用。
useConst	要求对仅分配一次的变量进行声明。
useDefaultParameterLast	强制 switch 语句中的默认子句位于最后
useDefaultSwitchClause	要求 switch 语句中有 default 子句。
useEnumInitializers	要求每个枚举成员值都明确初始化。
useExplicitLengthCheck	更好的做法是将所有设置保存在一个配置文件中并在整个项目中引用它。
useExponentiationOperator	禁止使用有利于运算符的运算符。
useExportType	提倡使用 for 类型。
useFilenamingConvention	强制相对导入的文件扩展名。
useForOf	此规则建议在循环中使用循环，索引用于从迭代数组中提取项目。
useFragmentSyntax	此规则强制使用超过。
useImportType	提倡使用 for 类型。
useLiteralEnumMembers	要求所有枚举成员都是文字值。
useNamingConvention	强制 JavaScript 和 TypeScript 文件名的命名约定。
useNodeAssertStrict	提倡使用 over 。
useNodejsImportProtocol	强制使用 Node.js 内置模块的协议。
useNumberNamespace	使用属性而不是全局属性。
useNumericLiterals	禁止和支持二进制、八进制和十六进制文字
useSelfClosingElements	防止没有子组件的组件有额外的结束标签
useShorthandArrayType	在表达数组类型时，此规则提倡使用简写而不是。
useShorthandAssign	尽可能要求赋值运算符简写。
useShorthandFunctionType	强制使用函数类型而不是带有调用签名的对象类型。
useSingleCaseStatement	强制 switch 子句只有一个语句，发出一个将语句封装在块中的快速修复。
useSingleVarDeclarator	禁止在同一个变量语句中声明多个变量
useTemplate	首选模板文字而不是字符串连接。
useThrowNewError	抛出错误时需要。
useThrowOnlyError	禁止抛出非值。
useWhile	当不需要初始化程序和更新表达式时，强制使用循环而不是循环。

可疑

¥Suspicious

检测可能不正确或无用的代码的规则。

¥Rules that detect code that is likely to be incorrect or useless.

规则名称	描述	属性
noApproximativeNumericConstant	使用标准常量而不是近似文字。
noArrayIndexKey	不鼓励在键中使用数组索引。
noAssignInExpressions	禁止表达式中的赋值。
noAsyncPromiseExecutor	禁止使用异步函数作为 Promise 执行器。
noCatchAssign	禁止在 catch 子句中重新分配异常。
noClassAssign	禁止重新分配类成员。
noCommentText	防止注释作为文本节点插入
noCompareNegZero	禁止比较
noConfusingLabels	禁止非循环的标记语句。
noConfusingVoidType	禁止泛型或返回类型之外的类型。
noConsole	禁止使用。
noConsoleLog	禁止使用
noConstEnum	禁止 TypeScript
noControlCharactersInRegex	防止在正则表达式中使用控制字符和一些与控制字符匹配的转义序列。
noDebugger	禁止使用
noDoubleEquals	要求使用和。
noDuplicateAtImportRules	禁止重复规则。
noDuplicateCase	禁止重复的案例标签。
noDuplicateClassMembers	禁止重复的类成员。
noDuplicateFontNames	禁止字体系列中的重复名称。
noDuplicateJsxProps	防止多次分配 JSX 属性。
noDuplicateObjectKeys	禁止在对象内部使用两个同名的键。
noDuplicateObjectKeys	禁止在对象内部使用两个同名的键。
noDuplicateParameters	禁止重复的函数参数名称。
noDuplicateSelectorsKeyframeBlock	禁止关键帧块中的重复选择器。
noDuplicateTestHooks	块不应包含重复的钩子。
noEmptyBlock	禁止 CSS 空块。
noEmptyBlockStatements	禁止空块语句和静态块。
noEmptyInterface	禁止声明空接口。
noEvolvingTypes	禁止变量通过重新分配演变为类型。
noExplicitAny	禁止使用类型。
noExportsInTest	禁止在包含测试的文件中使用或
noExtraNonNullAssertion	防止在 TypeScript 文件中错误使用非空断言运算符 ()。
noFallthroughSwitchClause	禁止子句的 fallthrough。
noFocusedTests	禁止重点测试。
noFunctionAssign	禁止重新分配函数声明。
noGlobalAssign	禁止分配给原生对象和只读全局变量。
noGlobalIsFinite	使用代替全局。
noGlobalIsNan	使用代替全局。
noImplicitAnyLet	禁止在变量声明中使用隐式类型。
noImportAssign	禁止分配给导入的绑定
noImportantInKeyframe	禁止在关键帧声明中无效
noLabelVar	禁止与变量共享名称的标签
noMisleadingCharacterClass	禁止在字符类语法中使用多个代码点构成的字符。
noMisleadingInstantiator	强制正确使用和。
noMisplacedAssertion	检查断言函数（例如）是否放置在函数调用中。
noMisrefactoredShorthandAssign	当变量出现在两侧时，禁止简写赋值。
noPrototypeBuiltins	禁止直接使用内置函数。
noReactSpecificProps	防止使用 React 特定的 JSX 属性。
noRedeclare	禁止在同一范围内重新声明变量、函数、类和类型。
noRedundantUseStrict	防止有多余的。
noSelfCompare	禁止在双方完全相同的情况下进行比较。
noShadowRestrictedNames	禁止标识符隐藏受限名称。
noShorthandPropertyOverrides	禁止覆盖相关长写属性的简写属性。
noSkippedTests	禁止禁用测试。
noSparseArray	禁止稀疏数组
noSuspiciousSemicolonInJsx	它检测 JSX 元素内可能的 “wrong” 分号。
noThenProperty	禁止使用属性。
noUnsafeDeclarationMerging	禁止接口和类之间不安全的声明合并。
noUnsafeNegation	禁止使用不安全的否定。
useAwait	确保函数使用。
useDefaultSwitchClauseLast	强制原始类型的一致名称
useErrorMessage	强制 onClick 至少伴随以下之一：
useGetterReturn	强制方法始终返回一个值。
useIsArray	使用代替。
useNamespaceKeyword	要求使用关键字而不是关键字来声明 TypeScript 命名空间。
useNumberToFixedDigitsArgument	强制使用带有的数字参数。
useValidTypeof	此规则验证一元表达式的结果是否与有效值进行比较，有效值可以是包含有效类型名称的字符串文字或其他表达式

规则

可访问性

复杂性

正确性

Nursery

性能

安全性

风格

可疑

推荐的规则