ESLint max-len配置异常：自定义120却触发140长度限制？

我正在配置ESLint，设置了规则：

"max-len": [1, { "code": 120 }]

我确认ESLint能读取该配置文件——因为之前配置出错时lint会直接报错。按照这个配置，行长度达到120时应该触发警告，但实际lint文件时却提示：

5:1 error This line has a length of 174. Maximum allowed is 140 max-len

我很困惑：官方文档说max-len默认值是80，这个140的限制到底来自哪里？而且为什么触发的是错误而非我设置的警告？看起来ESLint完全忽略了我的自定义配置，改用了某个未知的配置，这是怎么回事？

可能的原因及解决方法 #

遇到这种自定义规则被覆盖的情况，通常是以下几个原因导致的，你可以逐一排查：

1. 存在优先级更高的ESLint配置文件 #

ESLint会按特定顺序加载配置：从当前目录向上遍历，读取所有.eslintrc.*文件或package.json中的eslintConfig字段，上层目录的配置可能会覆盖当前项目的规则。

解决方法：
运行eslint --print-config 你的文件路径.js，这个命令会输出当前文件最终生效的ESLint配置。你可以在输出里搜索max-len，查看它的级别、参数以及配置来源（输出会标注每个规则的来源文件）。

2. 扩展的共享配置覆盖了你的规则 #

如果你的ESLint配置里extends了第三方规则集（比如airbnb-base、standard），这些规则集可能已经定义了max-len规则——不少流行规则集会把它设为错误级别（值为2）并限制140长度，正好匹配你遇到的情况。而且如果你的自定义规则写在extends之前，就会被覆盖。

解决方法：

• 确保自定义max-len规则写在extends之后；
• 用可读性更高的字符串级别明确覆盖，比如：

  "max-len": ["warn", { "code": 120 }]
  

• 若还是无效，可以先禁用共享配置里的规则再重新定义：

  "rules": {
    "max-len": "off",
    "max-len": ["warn", { "code": 120 }]
  }
  

3. ESLint缓存导致旧配置生效 #

ESLint默认会缓存lint结果，如果你之前修改过配置但没清缓存，新配置可能不会生效。

解决方法：
运行lint命令时加上--no-cache参数，比如：

eslint src/**/*.js --no-cache

或者手动删除项目里的node_modules/.cache/eslint目录（如果存在）。

4. IDE插件的额外配置干扰 #

如果你用VS Code之类的IDE，ESLint插件可能有单独的工作区设置，或者安装的Prettier等格式化插件自带行长度限制，甚至和ESLint规则冲突。

解决方法：

• 检查IDE的ESLint插件设置，确保启用了“使用工作区配置”；
• 暂时禁用Prettier等其他格式化插件，再测试lint结果。

5. 配置文件存在细微格式错误 #

虽然你说配置出错时会报错，但一些细微问题（比如逗号遗漏、引号不匹配）可能不会触发致命错误，却会导致规则不生效。

解决方法：
再检查一遍配置文件，确保max-len规则的数组结构完整、对象参数的括号闭合。

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