搜索你想找的开源项目

输入名称、用途或关键词,也可粘贴 GitHub 仓库链接

分享到微信

当前解读页的微信分享二维码

用微信扫一扫打开,点击右上角「···」分享给朋友或朋友圈。

手机上可截屏后,在微信扫一扫中从相册识别二维码。

cloudflare/oxlint-config

开发工具

为 Cloudflare 的 JavaScript 和 TypeScript 项目提供共享 Oxlint 规则,补充类型安全与 Promise 处理约束。

这个项目自带 1 个 Agent 技能看技能清单和安装方法 →
105
5
JavaScript
Apache-2.0
创建于 3 天前

项目介绍

@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。

  1. 安装预设和依赖:

    npm install -D @cloudflare/oxlint-config oxlint@^1.94.0 tsrs@^7.1.0-beta.tsrs2
    
  2. 在项目根目录创建 oxlint.config.ts,展开预设:

    import cloudflare from '@cloudflare/oxlint-config';
    import { defineConfig } from 'oxlint';
    
    export default defineConfig({ ...cloudflare });
    
  3. 项目自己的配置写在展开之后;要追加规则,展开 cloudflare.rules 或 cloudflare.overrides,不要整体替换。

  4. 在本地和 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 的记录撰写,更新于 ,以项目官方文档为准。

相关推荐

  1. voidzero-dev/vite-plus把 Vite、Vitest、Oxlint、Oxfmt、Rolldown 和任务缓存收进一个 CLI,让 Web 项目只用一套工具链和一份配置。Rust6,500
  2. microsoft/TypeScript给 JavaScript 加上可选类型,让大型前端项目在运行前就能检查重构错误。Go111,633
  3. cloudflare/workerd用于自托管 Cloudflare Workers 风格应用、本地开发与可编程 HTTP 代理的 JavaScript/Wasm 服务端运行时。C++9,130
  4. denoland/deno面向 JavaScript、TypeScript 与 WebAssembly 的安全运行时,常用于编写和运行服务器等应用。Rust108,769
  5. axios/axios面向浏览器和 Node.js 的 Promise 版 HTTP 客户端,用统一 API 发送请求,并支持拦截器、取消和进度事件。JavaScript109,393