Next.js中next lint与build时lint检查为何存在差异？

两者的核心差异 #

npx next lint和npm run build的校验逻辑确实存在区别：

• next lint是Next.js封装的ESLint命令，默认只扫描pages/、components/、lib/、src/这几个核心目录，且仅执行你在.eslintrc.json中配置的规则。
• next build在构建前会做全量项目校验，包括：
  • 扫描所有参与构建的文件（哪怕不在默认lint目录里，比如动态导入的工具文件、自定义配置文件）
  • 强制启用Next.js生产专属的构建规则（比如资源优化、路由合法性校验等，部分规则可能未包含在你当前的ESLint配置中）
  • 若项目使用TypeScript，会自动执行tsc --noEmit做类型检查（这部分next lint不会触发）

让next lint检测到build时的错误的方法 #

1. 让next lint检查所有文件 #

执行带目录参数的lint命令，覆盖默认扫描范围：

npx next lint --dir .

或者修改package.json中的lint脚本，以后每次执行npm run lint都会检查全量文件：

{
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start",
    "lint": "next lint --dir .",
    "format": "prettier --write ."
  }
}

2. 处理TypeScript类型检查（如果报错是类型问题） #

如果next build的错误是TypeScript类型错误，需要在lint流程中加入类型检查：

{
  "scripts": {
    // ...
    "lint": "next lint --dir . && tsc --noEmit"
  }
}

3. 检查ESLint忽略规则 #

查看项目根目录的.eslintignore文件，确认是否有忽略某些在build时会被用到的文件，若有则调整忽略规则，确保这些文件能被lint扫描到。

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