cloudflare/oxlint-config
开发工具为 Cloudflare 的 JavaScript 和 TypeScript 项目提供共享 Oxlint 规则,补充类型安全与 Promise 处理约束。
这个项目自带 1 个 Agent 技能看技能清单和安装方法 →项目介绍
@cloudflare/oxlint-config 是面向 JavaScript 和 TypeScript 项目的共享 Oxlint 预设。它在 @nkzw/oxlint-config 的基础上增加了类型安全、Promise 处理和 type-only import 相关规则,以 npm 包形式发布,采用 Apache-2.0 许可证。适合已经用 Oxlint 做代码检查、希望统一规则基线的团队。
快速使用
前提:Node.js 22.18 及以上(22.x 中第一个无需额外参数即可加载 oxlint.config.ts 的版本)、Oxlint 1.94+,以及负责类型感知的 tsrs。
-
安装预设和依赖:
npm install -D @cloudflare/oxlint-config oxlint@^1.94.0 tsrs@^7.1.0-beta.tsrs2 -
在项目根目录创建
oxlint.config.ts,展开预设:import cloudflare from '@cloudflare/oxlint-config'; import { defineConfig } from 'oxlint'; export default defineConfig({ ...cloudflare }); -
项目自己的配置写在展开之后;要追加规则,展开
cloudflare.rules或cloudflare.overrides,不要整体替换。 -
在本地和 CI 中运行
oxlint .。Oxlint 默认不报告 TypeScript 编译错误,因此 CI 中要保留类型检查命令,或设置options.typeCheck: true。
规则行为
启用的规则都按错误处理,且 Oxlint 的类别默认关闭,升级 Oxlint 不会通过类别归属悄悄开启新规则。几处值得注意的取舍:eqeqeq 也适用于 null 判断;typescript/no-misused-promises 会报告本应返回 void 的 Promise 回调;空接口、@ts-ignore、eval 和模块自引用都是错误;@ts-expect-error 必须附说明。TypeScript 用 typescript/only-throw-error,JavaScript 保留 no-throw-literal 并关闭五条 typescript/no-unsafe-* 规则。测试文件会关闭若干严格规则;no-console 全局生效,包括基础预设放行的入口文件,需要打日志处应加文件级覆盖。
迁移现有项目
先用一次通过的提交引入预设、临时关闭新报错的规则,然后每条规则单独提交启用(同时修复或写明保持关闭的理由),最后把一个迁移 PR 压缩合并。迁移技能为编程 Agent 提供完整流程,npm 包中同路径也附带该技能。
开发
按 CI 的方式安装 Vite+,使用 Node.js 24 LTS(24.11+),运行 vp install、vp check 和 vp test;vp pm pack 可打出 tarball 供消费方项目测试。漏洞请通过安全策略报告。
HotRepo 点评
该项目在 2026-11-22 出现在 HotRepo 新项目榜的 JavaScript 语言记录中,约 19:46–20:46 UTC 的一小时窗口内新增 3 星,累计 105 星、5 个 fork。这只是一次小时级新项目榜快照,不是持续趋势,说明的是小范围团队早期关注,而非广泛采用。可以确认的是交付方式:在既有预设上做的一层 Cloudflare 定制,配套迁移技能和经 CI 校验的 npm Trusted Publishing 发布流程。
本文由 AI 根据项目公开资料和 HotRepo 的记录撰写,更新于 ,以项目官方文档为准。
相关推荐
- voidzero-dev/vite-plus把 Vite、Vitest、Oxlint、Oxfmt、Rolldown 和任务缓存收进一个 CLI,让 Web 项目只用一套工具链和一份配置。
- microsoft/TypeScript给 JavaScript 加上可选类型,让大型前端项目在运行前就能检查重构错误。
- cloudflare/workerd用于自托管 Cloudflare Workers 风格应用、本地开发与可编程 HTTP 代理的 JavaScript/Wasm 服务端运行时。
- denoland/deno面向 JavaScript、TypeScript 与 WebAssembly 的安全运行时,常用于编写和运行服务器等应用。
- axios/axios面向浏览器和 Node.js 的 Promise 版 HTTP 客户端,用统一 API 发送请求,并支持拦截器、取消和进度事件。