NestJS项目中ESLint误报变量已定义未使用问题咨询

1. 导入路径拼写错误 #

你的代码里导入常量的路径写的是 'contants'，正确拼写应为 'constants'：

// 错误写法
import { MICROSERVICES, ReadStoreMccSubCategoriesDto } from 'contants';
// 正确写法
import { MICROSERVICES, ReadStoreMccSubCategoriesDto } from 'constants';

路径拼写错误会导致ESLint无法正确解析MICROSERVICES的结构，进而误判MCC_SUB_CATEGORY未被使用，同时运行时也可能触发模块找不到的报错。

2. ESLint规则配置不匹配TypeScript场景 #

在NestJS+TypeScript项目中，ESLint原生的no-unused-vars规则对TypeScript的解构、类型推导支持不足，容易出现误判，应该替换为@typescript-eslint/no-unused-vars规则。

检查你的ESLint配置文件（.eslintrc.js或.eslintrc.json），确保规则配置正确：

module.exports = {
  // ...其他配置项
  rules: {
    // 禁用原生规则
    'no-unused-vars': 'off',
    // 使用TypeScript专属规则
    '@typescript-eslint/no-unused-vars': ['error', {
      argsIgnorePattern: '^_',
      varsIgnorePattern: '^_'
    }]
  }
};

3. ESLint未识别TypeScript路径别名 #

如果constants是通过tsconfig.json的paths字段配置的路径别名，ESLint需要额外安装eslint-import-resolver-typescript来解析别名，否则无法找到对应模块，进而无法识别变量的使用情况。

先安装依赖：

yarn add -D eslint-import-resolver-typescript

再在ESLint配置中添加解析器设置：

module.exports = {
  // ...其他配置项
  settings: {
    'import/resolver': {
      typescript: {}
    }
  }
};

4. ESLint缓存导致误判 #

ESLint的缓存机制可能保留了旧的检测结果，尝试清理缓存后重新执行lint：

yarn lint --no-cache

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