ESLint如何在未转译ES5遗留代码库中识别ES6代码并强制规范？

我之前维护大型遗留代码库时也碰到过几乎一模一样的困境，给你几个经过实践验证的可行方案，不用写自定义ESLint插件也能解决：

别把ecmaVersion强行设为5——那样只会让解析器崩溃，根本没法做检查。反而把ecmaVersion设为6（或更高），让ESLint能正常解析所有代码，然后通过no-restricted-syntax规则来警告那些你不想出现的ES6特性。

比如可以在.eslintrc里这么配置：

{
  "parserOptions": {
    "ecmaVersion": 2018
  },
  "rules": {
    "no-restricted-syntax": [
      "warn",
      // 禁止let声明
      "Identifier[name='let']",
      // 禁止const声明
      "Identifier[name='const']",
      // 禁止对象解构
      "ObjectPattern",
      // 禁止对象属性简写
      "ObjectProperty[shorthand=true]",
      // 还可以加更多，比如箭头函数："ArrowFunctionExpression"
    ]
  }
}

这样既不会因为ES6语法导致ESLint报错终止，还能把所有违规的ES6代码标出来，方便你分批修复，甚至可以配合Git钩子阻止新的ES6代码提交到遗留库。

如果你的代码里有更复杂的ES6特性（比如类、箭头函数），普通ESLint解析可能处理得不够好，那就换用@babel/eslint-parser（原babel-eslint），它能完美解析所有ES6+语法，然后搭配ESLint插件的规则来禁用特定特性：

• 用babel/no-let禁止let声明
• 用babel/no-const禁止const声明
• 再结合no-restricted-syntax覆盖解构、箭头函数等其他场景

这种方式比单纯用no-restricted-syntax更精准，而且不会因为解析问题漏报。

手动改大量ES6代码太痛苦，试试用jscodeshift写简单的转换脚本，批量把常见ES6特性转成ES5：

• 把let/const批量替换成var（注意块级作用域的坑，可以先对稳定代码执行，再人工检查少数边界情况）
• 把对象简写{ a }转成{ a: a }
• 把数组解构const [a, b] = arr转成var a = arr[0], b = arr[1]

你可以先对已经稳定、不再迭代的遗留代码跑脚本，迭代中的代码暂时跳过，等迭代完成后再处理，这样能快速减少ES6代码的存量，不用耗费太多人力。

其实最彻底的解决方法是让构建管道能把所有代码（包括遗留库）都转译成ES5，这样你甚至不用强制代码写ES5。检查一下你的构建配置：

• 是不是有些目录被意外排除在Babel转译范围外了？比如src/legacy没加到babel-loader的include里？
• @babel/preset-env的targets配置是不是正确覆盖了你需要兼容的旧浏览器？比如有没有加ie 11？
• 有没有第三方依赖没被转译？可以调整babel-loader的exclude规则，确保所有需要兼容的代码都经过转译。

如果能搞定构建管道的问题，后面的代码规范压力会小很多——毕竟代码写ES6，转译后输出ES5，既兼顾开发效率又满足兼容性。

把代码分成「迭代中模块」和「稳定遗留模块」：

• 迭代中的模块可以暂时保留ES6（但必须确保被转译），优先完成业务功能
• 稳定遗留模块用上面的方法逐步清理ES6特性
• 同时用Git钩子（比如pre-commit）配合ESLint，阻止新的ES6代码提交到稳定遗留模块，避免问题扩大

这种方式能平衡业务迭代和技术债务修复，不会因为重构影响现有开发进度。

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