快速开始

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

安装

将 oxlint 安装为开发依赖：

npm

$ npm add -D oxlint

pnpm

$ pnpm add -D oxlint

yarn

$ yarn add -D oxlint

bun

$ bun add -D oxlint

在 package.json 中添加 lint 命令：

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-staged 进行预提交

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
• 学习高级功能：多文件分析、类型感知检查、JS 插件
• 迁移：从 ESLint
• 兼容性矩阵
• CLI 参考