快速开始

本页展示了 Oxlint 的推荐设置和最常见的工作流程，并提供可复制粘贴的命令。

安装

将 oxlint 安装为开发依赖：

npm

$ npm add -D oxlint

pnpm

$ pnpm add -D oxlint

yarn

$ yarn add -D oxlint

bun

$ bun add -D oxlint

将 lint 命令添加到 package.json：

package.json

{
  "scripts": {
    "lint": "oxlint",
    "lint:fix": "oxlint --fix"
  }
}

运行它：

npm

npm run lint

pnpm

pnpm run lint

yarn

yarn run lint

bun

bun run lint

应用修复：

npm

npm run lint:fix

pnpm

pnpm run lint:fix

yarn

yarn run lint:fix

bun

bun run lint:fix

用法

有关选项的完整列表，请参阅 CLI 参考。

oxlint [OPTIONS] [PATH]...

如果省略 PATH，Oxlint 将对当前工作目录进行 lint 检查。

常见工作流程

使用 lint-staged 进行 Pre-commit

npm

{
  "lint-staged": {
    "*.{js,jsx,ts,tsx,mjs,cjs}": "npm run lint"
  }
}

pnpm

{
  "lint-staged": {
    "*.{js,jsx,ts,tsx,mjs,cjs}": "pnpm run lint"
  }
}

yarn

{
  "lint-staged": {
    "*.{js,jsx,ts,tsx,mjs,cjs}": "yarn run lint"
  }
}

bun

{
  "lint-staged": {
    "*.{js,jsx,ts,tsx,mjs,cjs}": "bun run lint"
  }
}

创建配置文件

使用默认值初始化 .oxlintrc.json 配置：

oxlint --init

然后根据需要自定义 .oxlintrc.json。请参阅 配置。

或者，Oxlint 支持名为 oxlint.config.ts 的 TypeScript 配置文件。详见 配置。

然后运行 Oxlint：

oxlint

TIP

如果你是从 ESLint 迁移过来的，请参阅 “从 ESLint 迁移”页面 获取详细的迁移指南。

修复问题

应用安全修复：

oxlint --fix

应用建议（可能会改变程序行为）：

oxlint --fix-suggestions

应用危险修复和建议：

oxlint --fix-dangerously

请参阅 自动修复 了解何时使用每种模式的指南。

忽略文件

使用显式的忽略文件：

oxlint --ignore-path .oxlintignore

从命令行添加忽略模式：

oxlint --ignore-pattern "dist/**" --ignore-pattern "*.min.js"

禁用忽略处理：

oxlint --no-ignore

请参阅 忽略文件。

确保 CI 可靠失败

仅报告错误：

oxlint --quiet

如果发现任何警告则失败：

oxlint --deny-warnings

如果警告超过阈值则失败：

oxlint --max-warnings 0

请参阅 CI 设置。

使用机器可读输出

选择输出格式：

oxlint -f json

可用格式包括：default、json、unix、checkstyle、github、gitlab、junit 和 stylish。详见 输出格式。

检查有效配置

打印将用于文件的配置：

oxlint --print-config path/to/file.ts

列出可用规则

列出已注册的规则，包括当前 Oxlint 配置启用的规则：

oxlint --rules

完整列表位于 规则参考。

下一步

• 配置规则、插件和忽略项：配置
• 设置编辑器
• 设置 CI
• 学习高级功能：多文件分析、类型感知 lint、JS 插件
• 迁移：从 ESLint 迁移
• 兼容性矩阵
• CLI 参考