Skip to content
← Back to rules

typescript/restrict-plus-operands 严谨

💭 This rule requires type information.

它的作用

此规则要求加法运算符的两个操作数类型必须相同,且只能是 number、string 或 any。

为什么这是个问题?

JavaScript 的 + 运算符既可用于数值相加,也可用于字符串拼接。当操作数类型不同时,JavaScript 的类型强制转换规则可能导致意料之外的结果。此规则通过要求两个操作数具有兼容类型来帮助避免这些问题。

示例

此规则的错误代码示例:

ts
declare const num: number;
declare const str: string;
declare const bool: boolean;
declare const obj: object;

// 类型混合
const result1 = num + str; // number + string
const result2 = str + bool; // string + boolean
const result3 = num + bool; // number + boolean
const result4 = obj + str; // object + string

// 不同类型的字面量
const result5 = 42 + "hello"; // number 字面量 + string 字面量
const result6 = true + 5; // boolean 字面量 + number 字面量

此规则的正确代码示例:

ts
declare const num1: number;
declare const num2: number;
declare const str1: string;
declare const str2: string;

// 相同类型
const sum = num1 + num2; // number + number
const concat = str1 + str2; // string + string

// 显式转换
const result1 = num1 + String(num2); // 先转换为 string
const result2 = String(num1) + str1; // 先转换为 string
const result3 = Number(str1) + num1; // 先转换为 number

// 使用模板字面量进行字符串拼接
const result4 = `${num1}${str1}`; // 明确表达拼接意图

// 同类型字面量
const numResult = 42 + 58; // number + number
const strResult = "hello" + "world"; // string + string

配置

此规则接受一个配置对象,包含以下属性:

allowAny

type: boolean

default: true

是否允许在加法操作中使用 any 类型。

allowBoolean

type: boolean

default: true

是否允许在加法操作中使用 boolean 类型。

allowNullish

type: boolean

default: true

是否允许在加法操作中使用空值类型(nullundefined)。

allowNumberAndString

type: boolean

default: true

是否允许在加法操作中混合使用 number 和 string 操作数。

allowRegExp

type: boolean

default: true

是否允许在加法操作中使用 RegExp 类型。

skipCompoundAssignments

type: boolean

default: false

是否跳过复合赋值(例如 a += b)。

如何使用

要通过配置文件或 CLI 启用此规则,可以使用:

json
{
  "rules": {
    "typescript/restrict-plus-operands": "error"
  }
}
bash
oxlint --type-aware --deny typescript/restrict-plus-operands

参考资料