Next.js中next lint和eslint .命令的核心区别是什么？
2026-9-29
next lint 与 eslint . 命令的核心区别 - 配置适配差异：
next lint是NextJS官方封装的专属lint命令，默认自动加载内置的eslint-config-next规则集，无需额外配置即可支持NextJS特有场景的校验，包括App Router/Pages Router的路由规范、React Server Components语法、next/image/next/link等专属API的最佳实践校验。直接运行eslint .只会读取项目本地的ESLint配置文件，若未手动引入eslint-config-next规则集，不会触发上述NextJS专属校验，甚至会对NextJS特有语法抛出误报。 - 扫描范围差异：
next lint默认仅扫描pages/、app/、components/、lib/四类业务常用目录，自动忽略node_modules、.next等依赖与构建产物目录，无需额外配置忽略规则，执行速度更快。eslint .默认扫描当前目录下所有匹配后缀的文件，若未配置.eslintignore，会包含大量无需校验的文件，执行效率低且容易出现无关报错。 - 特性支持差异：
next lint原生适配NextJS生态能力，可通过--dir参数指定自定义校验目录，同时可与NextJS构建流程无缝集成，执行next build时默认自动触发lint校验，规则不通过会直接阻断构建。eslint .为ESLint原生命令，所有NextJS相关的适配、集成逻辑都需要手动配置实现。 - 依赖要求差异：
next lint依赖NextJS项目内置的相关包即可运行，无需全局安装ESLint。直接运行eslint .需要你全局安装了ESLint，或是在项目scripts中声明调用本地node_modules中的ESLint依赖，否则会触发命令不存在的报错。
内容的提问来源于stack exchange，提问作者Rodrigo
相关产品推荐
相关产品推荐
