如何配置lint-staged使ESLint仅针对变更文件执行,以优化pre-commit脚本耗时?
解决lint-staged全量扫描问题,仅处理变更文件
你的问题根源很明确:当前lint-staged配置里的ESLint和Prettier命令都硬编码了全局文件路径,完全忽略了lint-staged传递的变更文件列表,导致每次运行都会扫描整个项目,自然慢得离谱。
正确的配置方式
lint-staged的核心逻辑是:它会自动把当前变更的文件路径作为参数传递给你配置的命令,所以你不需要在命令里写死全局路径,只需要保留工具本身的命令选项即可。
修改后的lint-staged配置如下:
"lint-staged": { // 针对src下的ts/js/json文件,依次执行ESLint修复和Prettier格式化 "src/**/*.{ts,js,json}": [ "eslint --fix", "prettier --write" ], // 如果test目录下的文件也需要处理,单独添加规则 "test/**/*.{ts,js}": [ "eslint --fix", "prettier --write" ] }
为什么原来的配置会慢?
看你原来的ESLint命令:
eslint "{src,apps,libs,test}/**/*.ts" --fix
这里你直接指定了要扫描的全局路径,ESLint会完全忽略lint-staged传递的变更文件,强制执行全量扫描。Prettier的命令也是同理:
prettier --write "src/**/*.ts" "test/**/*.ts"
不管你改了1个还是10个文件,它都会格式化所有符合路径的文件,这才是耗时的关键。
额外注意事项
- 如果你的项目里有不同类型的文件需要不同的处理规则(比如样式文件),可以单独添加匹配规则,比如
"src/**/*.{css,scss}": ["stylelint --fix"]。 - 确保你的ESLint和Prettier配置文件(
.eslintrc.js、.prettierrc等)已经正确配置,不需要在命令里额外指定路径——lint-staged会帮你把变更文件精准传递给工具。 - 你的
pre-commit脚本配置"pre-commit": "lint-staged"是正确的,不需要修改。
内容的提问来源于stack exchange,提问作者rb27




