You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Next.js构建时遇ESLint规则禁用提示错误的解决求助

解决Next.js构建时ESLint报错问题

本地开发正常,但执行npm run build时触发ESLint规则校验失败,这是因为Next.js在构建阶段默认会严格执行ESLint检查,而开发模式下可能未开启全量校验。给你三种解决办法:

  • 临时跳过校验快速部署(不推荐长期使用)
    修改package.json里的build脚本,添加--no-lint参数跳过ESLint检查:

    "scripts": {
      "dev": "node server.js",
      "build": "next build --no-lint",
      "start": "NODE_ENV=production node server.js"
    }
    

    修改后重新执行npm run build即可完成构建。

  • 查看具体错误并修复(推荐)
    先执行npm run lint命令,终端会输出具体的ESLint错误细节,比如未使用变量、组件命名不规范等,跟着提示逐个修复代码里的问题,修复后再执行npm run build就能正常构建。

  • 禁用特定ESLint规则
    如果某些规则对你的项目没必要,可在项目根目录创建(如果没有的话).eslintrc.json文件,继承Next.js默认规则的同时关闭不需要的规则,示例配置:

    {
      "extends": "next/core-web-vitals",
      "rules": {
        // 示例:关闭未使用变量的检查
        "no-unused-vars": "off",
        // 示例:关闭Next.js对img标签的强制校验
        "@next/next/no-img-element": "off"
      }
    }
    

    具体要关闭哪些规则,参考npm run lint输出的错误提示,把对应的规则名加到rules里设为"off"即可。

内容的提问来源于stack exchange,提问作者MUHAMMAD HARIS

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.20 07:54:26