如何解决对象解构仅用rest/spread时的TS未使用变量警告

日常开发中写如下解构代码时，只要被排除的属性后续没有被引用，就会触发TypeScript/ESLint的未使用变量警告：

const { products, ...restCartProps } = cart;
// 后续逻辑仅使用restCartProps，未使用products

对应场景示例：

以下是几种符合编码规范、不会破坏规则校验能力的解决方案：

1. 配置规则忽略占位符变量（推荐） #

@typescript-eslint/no-unused-vars和原生ESLint的no-unused-vars规则都支持自定义忽略匹配规则，你可以配置规则自动忽略以下划线开头的未使用变量：

// .eslintrc 配置片段
module.exports = {
  rules: {
    "@typescript-eslint/no-unused-vars": [
      "warn",
      {
        varsIgnorePattern: "^_", // 忽略_开头的变量
        argsIgnorePattern: "^_",
        destructuredArrayIgnorePattern: "^_"
      }
    ]
  }
}

配置完成后，把不需要使用的解构属性重命名为下划线前缀的变量即可，语义上也能明确表示该变量是故意不使用的：

const { products: _products, ...restCartProps } = cart;

*如果你使用TypeScript 4.2及以上版本，支持直接用单下划线_作为丢弃占位符，同一个作用域内可以重复使用_，不会触发重复声明报错：

// TS 4.2+ 支持的最简写法
const { products: _, ...restCartProps } = cart;
const { owner: _, ...orderData } = order; // 重复使用_不会报错

2. 封装属性排除工具函数 #

如果不想修改ESLint配置，可以封装一个通用的属性剔除方法，从根源上避免声明未使用的变量：

/**
 * 从对象中排除指定属性，返回剩余属性组成的新对象
 */
function omit<T extends Record<string, unknown>, K extends keyof T>(
  obj: T,
  keys: K[]
): Omit<T, K> {
  const result = { ...obj };
  keys.forEach(key => delete result[key]);
  return result;
}

// 使用示例，不需要解构出要丢弃的属性
const restCartProps = omit(cart, ['products']);

这种写法完全不会触发未使用变量校验，语义清晰，适合项目中频繁需要剔除对象属性的场景。

3. 行级禁用规则（仅适合临时单次使用场景） #

如果只是偶尔出现这类场景，不想做全局配置，也可以在对应代码行上方加注释临时禁用规则：

// eslint-disable-next-line @typescript-eslint/no-unused-vars
const { products, ...restCartProps } = cart;

注意：不要全局关闭no-unused-vars规则，该规则可以有效帮你清理冗余声明、避免无用代码占用体积，全局关闭会损失很多代码校验能力。

内容的提问来源于stack exchange，提问作者Gaurav