oxlint
oxlint 是一个新兴的代码检查工具,默认情况下不需要任何配置,主要用于脚本文件。
oxlint 的定位
oxlint 不能完全取代 ESLint。相反地,因为 oxlint 非常快,所以 oxlint 可以作为 ESLint 的补充。你可以在运行 ESLint 前运行 oxlint,获取更快的反馈循环。
安装
首先你需要安装 oxlint。目前支持 oxlint v0.5。
shell
npm install oxlint -D
shell
yarn add oxlint -D
shell
pnpm install oxlint -D
shell
bun install oxlint -d
配置
CLI
更新你的 package.json
,增加 lint:oxlint
命令。
json
{
"scripts": {
"lint:oxlint": "oxlint --fix"
}
}
忽略文件
ESLint 配置提供了 .gitignore、.eslintignore 和一部分内置忽略文件支持,而 oxlint 只支持指定单个忽略模式文件,默认会使用 .gitignore 和 .eslintignore 两个忽略模式文件。
如果你有其它的文件需要忽略,你可以像下面例子使用 --ignore-pattern
。这个例子忽略了所有 dts 文件,在自动生成 dts 文件的项目中很有用。
json
{
"scripts": {
"lint:oxlint": "oxlint --ignore-pattern=*.d.ts --fix"
}
}
整合
VSC
安装 对应的 oxlint 插件 即可。
lint-staged
如果你使用该库提供的 lint-staged 配置,请查看 lint-staged 章节。
如果你没有使用该库提供的 lint-staged 配置,可以参考以下配置。
javascript
// lint-staged.config.mjs
// or lint-staged.config.js with "type": "module" in package.json
import { filterFilenames } from '@modyqyw/fabric';
export default {
'*.{js,cjs,mjs,jsx,ts,cts,mts,tsx,vue}': (filenames) => {
const filtered = filterFilenames(filenames);
return [
`oxlint --fix ${filtered.join(' ')}`,
`eslint --fix --cache --no-error-on-unmatched-pattern ${filtered.join(' ')}`,
];
},
};