跳到主要内容
api工厂
工程化

oxlint 与 Oxc:Rust 系 lint 的速度与边界

api工厂资讯栏目 约 5 分钟阅读
本文由 AI 辅助生成,内容基于公开资讯整理改写,技术细节以官方文档为准。
内容摘要oxlint 1.0 于 2025 年 6 月稳定,tsgolint 补齐类型感知能力,大型仓库提速 12~18 倍。本文讲清速度来源、规则边界与三步渐进迁移方案。

结论先行:oxlint 用 Rust 重写 lint 引擎,官方基准比 ESLint 快 50~100 倍,1.0 稳定版于 2025 年 6 月发布;2026 年 7 月类型感知引擎 tsgolint 转正后,它已能覆盖 typescript-eslint 绝大多数类型感知规则,「快但只能查语法」的旧印象需要更新。 本文讲清 oxlint 的速度来源、能力边界与渐进式迁移路径,帮你判断该不该上、怎么上。

速度从哪里来

ESLint 的开销大头在 JavaScript 单线程运行时、逐文件构建 AST 以及类型感知规则对 TypeScript 编译器的反复查询。oxlint 的对策是:Rust 实现解析与规则执行、多线程并行遍历文件、默认不加载类型信息。官方基准中,26 万文件级别的仓库用 101 条规则、10 线程约 22.5 秒跑完,吞吐约每秒一万文件。对大型 monorepo,这意味着 lint 从「分钟级门禁」变成「秒级反馈」,可以直接塞进 pre-commit 而不惹恼开发者。

规则覆盖与边界

1.0 版本即支持 500 余条规则,覆盖 ESLint 核心规则与 unicorn、import、react、react-hooks、jest、jsdoc 等常用插件,并附带 const-comparisons 等独有规则。配置采用 .oxlintrc.json,支持嵌套配置与 overrides,提供 oxlint-migrate 工具从 ESLint 配置自动迁移。边界也要看清:自定义规则生态仍在追赶 ESLint,深度绑定特定框架的小众插件可能没有对应实现;Vue/Svelte 单文件组件的支持程度随版本演进,落地前以官方文档为准。

类型感知:tsgolint 转正

2026 年 7 月,Oxc 团队发布基于 TypeScript 7(Go 原生编译器)的 tsgolint,类型感知 lint 正式稳定,覆盖 typescript-eslint 61 条类型感知规则中的 59 条。用法:

bash
pnpm add -D oxlint oxlint-tsgolint
pnpm oxlint --type-aware
pnpm oxlint --type-aware --type-check

加上 --type-check 后,lint 与类型检查共享同一个 TypeScript program,省掉单独跑一次 tsc 的重复分析。官方在四个大型仓库上的基准:

仓库ESLint + typescript-eslinttsgolint提速
microsoft/vscode83.2s6.96s12x
microsoft/typescript27.2s1.94s14x
typeorm/typeorm13.2s0.75s18x
vuejs/core12.3s0.95s13x

注意 tsgolint 版本号与 TypeScript 版本强绑定(如 v7.0.2000 对应 TS 7.0.2),项目 TS 版本需满足要求;还可用 --debug timings 输出每条规则耗时,精准定位最贵的规则。截至 2026 年 11 月,oxlint 已迭代到 1.9x 系列并支持自动发现类型感知引擎,细节以官方发布为准。

编辑器与诊断体验

速度之外,日常体验同样重要。oxlint 提供 VS Code 等编辑器扩展,保存即反馈;诊断信息带清晰的规则说明与定位,支持 --fix 自动修复可修复项。团队落地时建议把 oxlint 命令写进根 package.json 的 scripts 并统一版本锁定,避免「本地一个版本、CI 一个版本」导致规则行为漂移;升级前先在分支上全量跑一遍,确认新增规则没有引入大面积报错,再合入主干。

与 ESLint 共存的迁移路径

不建议一刀切。推荐三步:第一步,先跑 npx oxlint 零配置摸底,修复高价值问题;第二步,用 oxlint-migrate 迁移配置,再引入 eslint-plugin-oxlint 关闭 ESLint 中已被 oxlint 覆盖的规则,两者共存、各查各的;第三步,观察一个迭代周期,确认无规则缺口后,把 ESLint 收缩到仅剩自定义插件的场景,甚至完全替换。CI 中把 oxlint 放在门禁最前面,秒级失败、秒级反馈。

什么团队适合先上

文件数千以上、lint 耗时已成瓶颈的 monorepo 收益最大;小仓库则更多是体验收益。练手可以用 api工厂开源的 vueMinishop、wechat-app-mall 商城前端(https://www.it120.cc/help/uq920k.html),代码量适中、目录结构真实。这类项目的后端接口由 api工厂平台托管,前端仓库没有服务端代码混杂,lint 范围干净,很适合作为 Rust 系工具链的试验田;接口调试可直接用官方 Playground(https://www.it120.cc/playground.html)完成。

文章标签

oxlintOxcRustlint

相关产品

api工厂是面向开发者的开放 SaaS 平台:开箱即用的后台管理系统 + 全端 SDK,只需前端开发即可构建小程序、App、H5 与网站。

前端测试VitestPlaywright

前端测试金字塔:Vitest 单元测试 + Playwright E2E 落地

按测试金字塔划分单测、组件测试与 E2E 职责,给出 Vitest 与 Playwright 配置示例、真实商城链路用例、CI 分段策略与闪断治理方法。

工程化约 6 分钟阅读