ESLint误报构造函数/枚举未使用：如何识别app.ts中的引用？

在Node.js + Express + TypeScript项目中，明明入口文件app.ts已经引用了某些类或枚举，但ESLint仍标记它们为未使用，具体场景如下：

handler/RequestHandler.ts中的类定义：

export class RequestHandler {
    constructor (private readonly manager: Manager) {}
    // ... 其他方法
}

app.ts中的使用代码：

import { RequestHandler } from './handler/RequestHandler'
// ....
const handler = new RequestHandler(manager)

运行ESLint时收到错误：

/path-to-my-project-root/src/handler/RequestHandler.ts
  5:2  error  Useless constructor  no-useless-constructor

已确认ESLint并未忽略app.ts（修改app.ts添加多余空格时，ESLint会正常报错），且枚举值也存在同样的误报情况。

解决方案 #

1. 替换原生ESLint规则为TypeScript专属规则 #

原生ESLint的no-useless-constructor规则无法识别TypeScript中带访问修饰符（private/protected/public）的构造函数——这类构造函数并非无用，它同时完成了类成员初始化与依赖注入。

在ESLint配置文件（.eslintrc.js或.eslintrc.json）中修改规则：

module.exports = {
  rules: {
    "no-useless-constructor": "off",
    "@typescript-eslint/no-useless-constructor": "error"
  }
};

2. 检查ESLint的文件扫描范围 #

确保配置中的include字段覆盖所有源文件（包括入口文件app.ts），避免分析时遗漏跨文件引用关系：

{
  "include": ["src/**/*.ts", "app.ts"]
}

3. 修复枚举未使用的误报 #

原生no-unused-vars规则无法识别TypeScript枚举的跨文件引用，需替换为@typescript-eslint/no-unused-vars：

module.exports = {
  rules: {
    "no-unused-vars": "off",
    "@typescript-eslint/no-unused-vars": ["error", {
      "varsIgnorePattern": "^_",
      "argsIgnorePattern": "^_"
    }]
  }
};

4. 清除编辑器ESLint缓存（编辑器集成场景） #

如果在VS Code等编辑器中使用ESLint插件，缓存可能导致误报，可通过命令面板重启ESLint服务：
打开Ctrl+Shift+P，输入ESLint: Restart ESLint Server执行重启。

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