重启React项目时出现linter constructor报错如何排查修复

这个linter构造函数报错是ESLint生态的典型版本兼容问题，无复杂业务层面诱因，常见触发逻辑：

• 依赖版本错配：Create React App创建的项目默认会托管ESLint及相关插件的版本，如果你手动在devDependencies里安装了和react-scripts要求版本不一致的ESLint，或是重装依赖时版本自动升级跨了大版本，ESLint主程序和配套的规则插件、配置包的类调用逻辑不匹配就会抛错——高版本ESLint把Linter改成了ES6 Class，必须用new关键字初始化，旧版适配插件还在按ES5构造函数的方式直接调用，就会触发构造函数调用错误。
• 缓存损坏：node_modules文件残缺、CRA生成的.cache构建缓存损坏，哪怕依赖版本正确，读取到损坏的缓存文件也会触发同类错误，这也是反复重启项目无效的核心原因，重启只会重新读取已有缓存，不会修复损坏的文件。
• Node版本不匹配：本地Node.js大版本和项目依赖要求的版本差距过大，部分ESLint依赖的原生模块编译失败，也会抛出构造函数相关错误。

按顺序操作，每步做完重启开发服务验证即可，不需要修改业务代码：

1. 全量清理损坏文件
   先停掉本地运行的dev server，在项目根目录执行命令删除旧依赖和缓存：

   # 删除依赖目录和包管理器锁文件
   rm -rf node_modules package-lock.json yarn.lock pnpm-lock.yaml
   # CRA项目额外删除构建缓存
   rm -rf .cache
   

2. 修正依赖配置
   打开根目录下的package.json，找到devDependencies节点，把手动添加的eslint字段直接删掉——CRA项目不需要手动声明ESLint依赖，react-scripts会自带适配好的版本，手动声明反而会覆盖版本触发冲突。
   如果是自行搭建的非CRA React项目，把ESLint和所有关联插件（eslint-plugin-react、eslint-plugin-jsx-a11y、eslint-plugin-react-hooks、各类第三方eslint-config包）的版本统一到同一个大版本，比如全部用8.x系列，不要出现主版本号混搭的情况。
3. 重新安装依赖
   按使用的包管理器执行安装命令：

   # npm用户
   npm install
   # yarn用户
   yarn
   # pnpm用户
   pnpm install
   

4. 兜底校验
   如果上面三步做完还是报错，检查项目根目录.nvmrc或者package.json里engines字段要求的Node版本，用nvm切换到对应版本后重新走一遍清理、安装依赖的流程即可。
   要是使用了第三方ESLint共享配置（比如airbnb、alloy等），可以临时把.eslintrc里extends字段的第三方配置注释掉，确认是配置包版本不兼容的话，把对应配置包降到和ESLint主版本匹配的版本就行。

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