如何在整个Next.js项目中禁用ESLint jsx-a11y/alt-text规则

你之前的配置未生效，核心问题是填写了错误的规则名称。
相关配置参考截图：

失效原因 #

jsx-a11y/img-has-alt 是eslint-plugin-jsx-a11y 6.x之前版本的旧规则名，当前Next.js内置集成的新版jsx-a11y插件中，负责校验图片alt属性的规则已经正式更名为 jsx-a11y/alt-text，旧规则名不会被识别，因此配置无效。

正确配置代码 #

修改项目根目录下的.eslintrc.json文件，替换为如下配置即可全局关闭该规则：

{
  "extends": ["next/core-web-vitals", "prettier"],
  "rules": {
    "prefer-const": "error",
    "indent": ["error", 2],
    "jsx-a11y/alt-text": "off"
  }
}

配置后校验不生效的排查步骤 #

• 保存配置后重启本地next dev服务，同时重启编辑器的ESLint插件，清除旧配置缓存
• 确认当前修改的.eslintrc.json位于项目根目录，没有被业务子目录下的其他ESLint配置覆盖优先级
• 根目录配置默认对全项目所有目录（包括Next.js 13+的app目录、pages目录）生效，无需额外为单独目录重复配置

提示：jsx-a11y类规则用于校验站点无障碍访问能力，非特殊业务场景不建议长期全局关闭。

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