如何仅针对TypeScript接口禁用ESLint的no-unused-vars规则？

云上老周

2026-8-6

解决TypeScript类型定义中no-unused-vars规则误报问题

问题原因

你当前启用了原生ESLint的no-unused-vars规则，但原生规则无法识别TypeScript类型定义中的参数（比如你代码里format属性的value参数），会误判为未使用变量。而你关闭了专门针对TypeScript的@typescript-eslint/no-unused-vars规则，反而放弃了能正确处理TS语法的规则支持。

解决方案

正确的做法是禁用原生ESLint的no-unused-vars，启用@typescript-eslint/no-unused-vars规则——它会自动忽略TypeScript类型、接口中的未使用参数，同时在普通JS/TS代码中正常检查未使用变量。

修改ESLint配置

更新你的eslintrc.json规则配置：

"rules": {
    "no-unused-vars": "off",
    "@typescript-eslint/no-unused-vars": [
        "warn",
        {
            // 可选配置：忽略以下划线开头的变量/参数
            "argsIgnorePattern": "^_",
            "varsIgnorePattern": "^_",
            // 忽略对象解构中未使用的剩余属性
            "ignoreRestSiblings": true
        }
    ]
}

临时行内禁用（可选）

如果你只想针对某一行类型代码禁用规则，也可以用行内注释：

export type IKeoTableColumn<T> = {
  id: T;
  align: 'left' | 'center' | 'right';
  label: string;
  minWidth: number;
  // 仅针对当前行禁用原生no-unused-vars规则
  format?: /* eslint-disable-next-line no-unused-vars */ (value: number) => string,
}[];