一个用 Rust 重写 TypeScript 7 编译器的仓库,在 2026 年 11 月 8 日的 GitHub API 快照里攒到 3003 星,却连一个稳定版都还没发出来。点开 oxc-project/tsrs 的人,多半会先被这个反差绊一下:README 里写得明明白白,它是 TypeScript 7 编译器与语言服务器的 drop-in replacement,用 Rust 写成;可同一份 README 又写着,团队的目标是「对着 TypeScript 7.1 发一个 100% conformance 的稳定版」,用的是 aim to,是目标,不是已经交出的答卷。星数、语言、许可证、建仓与推送时间都能在接口里逐项核到,但「什么时候能稳定使用」这一栏,仓库给出的答案仍是 beta 与预发布。这篇就把这一个仓库拆开:三千多颗星是怎么来的、卡在哪、那些到处流传的提速数字到底各是谁测的,以及现在能不能把它换进生产链路。
先把同批几篇的分工说清楚,免得读串。本篇只做 oxc-project/tsrs 这一个仓库的深拆,落在仓库事实、beta 状态、PR 关闭的人力现实与三套提速基准的口径上,不做多项目排行;OpenAI Images 2.6 的 GIF 与 SVG 增量讲单一产品的发布事件与官方能力口径,Cosmos 3 Nano 四条后训练路径对照讲另一组对象的机制拆解,Google ADK 2.14.0 升级避坑讲 breaking changes 的逐条处理,三条线都与这里不同。同为 Rust 项目,craft-anything 净室引擎讲的是游戏引擎的净室重写与双许可,五款 AI 工具元数据横评摆的是多个互不相干仓库某时点的客观参数表,本篇不列清单、不比元数据,只把这一个仓库讲透;许可证条款的横向比较站内另有开放权重许可横评,这里只陈述 Apache-2.0 这一件事实,不做条款对照。
先把仓库事实钉死:3003 星是哪一刻的数
GitHub REST 接口 /repos/oxc-project/tsrs 在 2026-11-08T11:51:54Z 的快照给得很齐:3003 stars、主语言 Rust、许可证 Apache-2.0、created 2026-10-01T15:14:18Z、pushed 2026-11-07T17:19:37Z、forks 61、open_issues 53、default_branch main,描述一栏是 "Rust port of the TypeScript 7 type checker"。这些数字一律带抓取时点才作数:同一批抓取里 11:37:30Z 那次是 3002 星,差一小时就差一颗,拿别的时点的数来覆盖或校验这一条都不成立。owner 也钉死是 oxc-project,按其它组织名猜出来的路径在探测里都返回 404,写错 owner 就等于指向一个不存在的仓库;精确串 oxc-project/tsrs 在文中反复出现,正是为了避免这种漂移。想亲手克隆或逐项核对,明文地址记一次就够:https://github.com/oxc-project/tsrs。
许可证三处口径一致:API 的 license 字段、README 徽章、LICENSE 全文都是 Apache-2.0。README 还补了几句归属:它是 TypeScript 的衍生作品,版权归 Microsoft Corporation,捆绑的 lib.*.d.ts 文件来自 TypeScript,并声明 Not affiliated with or endorsed by Microsoft。这些照录即可,许可证以 LICENSE 原文为准,本文不做条款解读,也不做许可证之间的横向比较。把这一节的事实摆平,后面谈状态与提速才有共同的坐标:TypeScript 7 是被替代的编译器版本,TypeScript 7.1 是稳定版要对齐的目标。
README 里的三句话:定位、目标、人力
README 里有三句值得逐字读。第一句是 tsrs is a drop-in replacement for the TypeScript 7 compiler and language server, written in Rust.,给的是定位:作为 TypeScript 7 编译器与语言服务器的直接替代,用 Rust 写成。第二句是 We aim to release a stable version against TypeScript 7.1 with 100% conformance.,给的是目标:对着 TypeScript 7.1 发一个 100% conformance 的稳定版,关键词是 aim to,说明这是尚未兑现的承诺,不是已完成的验收。第三句是 Pull requests remain closed because we don't have the bandwidth to review them.,给的是最容易被宣传稿吞掉的一条现实:PR 保持关闭,理由直白到有点不体面,没有足够人力去评审。issue 仍开放,PR 暂不收,社区能报问题,但改动合入的节奏不由外部推动。
VoidZero 2026 年 11 月 5 日的十月回顾里另有一句 tsrs is not a fork,并说与 TypeScript 团队紧密协作、目标 100% 符合 TypeScript 7.1、性能改进会回馈上游。这是仓库外旁证的措辞,按来源标注即可,不能写成 README 的自述。把三句话连起来看,项目的自我描述其实相当克制:一个 Rust 写的替代实现,一个还没达成的符合度目标,一个坦白说人手不够的社区状态。3003 星是关注度,不替它回答「做完了没有」。
beta 的节奏:docs/STATUS.md 里写了什么
docs/STATUS.md 有 1041 行,把发布节奏摊开看:包版本串是 0.23.0-ts7.1.0-beta、0.22.0-ts7.1.0-beta,还有 0.20.0 beta 这样的小节标题;正文里出现 "creates a GitHub prerelease"、"npm's beta tag is assigned manually"、"release candidate" 这些字样。连起来读,发布流程会生成 GitHub 预发布,npm 的 beta 标签是手动挂上去的,版本走到过候选发布的说法,但没有任何一处宣布 stable 已经落地。所以准确写法是 beta / 预发布、稳定版未发布,成熟度标签只到预发布这一档,别往上抬。
有一处节奏细节值得顺带记下:README 说 --fast 与相关默认预设自 0.20.0 起可用,也可以写成 TSRS_FAST=1;默认是四个 checker(按文件数封顶),沿用 Go 的文件分配与 checker 历史,fast 则自适应 checker 数、分组任务、加额外缓存,并保持 strict、skipLibCheck、noCheck 这些配置。这解释了自己动手跑基准时为什么开不开 --fast 会落到不同区间,也提醒读者别把某个版本、某个开关下的结果当成项目全貌。README 里没有把成熟度写成别的档次,全文对自身的定位就是那句 drop-in replacement,仓库也没把某种自动生成方式写进官方定位。
三套提速数字,为什么不能互相印证
这一节最容易写岔。项目名下不止一组「快 N 倍」的数字,它们来自不同发布主体、对着不同基线版本、在不同机器上用不同方法测出来,彼此不能换算、不能相加,也不能拿一组去解释另一组。下面按来源分开摆,每一组都连对比对象一起带上。
仓库外那一组来自 Cloudflare 官方博客,说法是 up to 8x faster 与 ~70% less memory,条件是与 TypeScript 7.0 对比、相同 checker worker 数。它不在仓库自带的基准文件里,属于官方博客口径,引用时要连「对 TypeScript 7.0」一起带上,别把它当成仓库里可复现的实测表。
仓库内那一组才是项目方自己的可复现基准,在 bench/RESULTS.md(2026-11-08T11:51:54Z 实抓,8295 字符):19 个项目、Apple M3 Max 14 核 36GB、测量日 2026-10-28、Hyperfine 2.0.0 十次交错中位数(TypeScript 五次),对比 TypeScript 7.1.0-beta 与 tsrs 0.20.1-ts7.1.0-beta,命令统一带 --noEmit --incremental false --pretty false。结果是墙钟 1.71x-6.62x faster、峰值内存 1.70x-2.75x less,并且 TypeScript、tsrs、tsrs --fast 三者对每个项目报出的诊断(文件、位置、错误码)一致。bench/README.md 说 projects.json 固定了公开仓库与 commit、bench/publication.json 存全精度值,图表与报告能字节级复现。要紧的是定性:这是项目方自测,不是第三方独立实测;本次抓取的 README、RESULTS.md、bench/README.md、STATUS.md 里没有第三方复测的记载,仓库内未见第三方复测。
第三方那一组同样要分开看:ImportStatic 约 2.7x,对 TypeScript 7.1 beta、用 TypeScript 自身源码;Frank Chu 报 5.3x 与内存 -72%,条件是 400 文件、2 核、默认设置、对 TypeScript 7.0.2;Cloudflare 自家图表另列四个项目 3.8x-8.1x。微软的 Daniel Rosenwasser 回应过,说速度提升不全来自语言,TypeScript 7.1 里有一部分提速来自 tsrs 的回馈。这些是各自条件下的观察值,不与前两组拼成一张表,也不互相折算。
把三组并成「官方八倍、实测二点七倍」式的落差,是这组材料里最常见的误读。基线版本本就不同:一组对 TypeScript 7.0,一组对 7.1.0-beta,一组对 7.0.2;测量机器、项目集合、是否开 --fast、跑几次取中位数、由谁发布,全都不一样。数字之间既不能换算,也不能拿一组去解释另一组;它们只回答各自那套条件下的问题。标题里若把不同基准的倍数摆在一起造反差,读者会读成「某一方吹大了」,而这并不是材料能推出的结论。能写的是「三套口径各自成立、互不印证」,不能写的是把它们折算成一个统一倍数。
能力边界:WASM、language server 与类型感知 lint
README 自述里含 language server,仓库也确实有一串文档:docs/LSP.md、docs/USAGE.md、docs/NODE_API.md、docs/COMPATIBILITY.md、docs/DEFAULTS.md、docs/STATUS.md。@tsrs/wasm 把目标定在 wasm32-wasip1(WASI Preview 1),让类型检查能跑在浏览器、Workers 与嵌入式环境;另有 tsrs playground,可在浏览器里试检查与产出代码。VoidZero 十月回顾提到后续会驱动 Oxlint 的类型感知 lint(61 条规则)以及 playground,这些按仓库外来源标为规划方向,不写成已经交付的能力。
安装命令按 README 是两条:
pnpm add -D tsrs
pnpm exec tsrs --noEmit --fast
TSRS_FAST=1 pnpm exec tsrs --noEmit仓库外资料(Cloudflare 博客、InfoQ、VoidZero)另给了 npm install -D tsrs 加 npx tsrs -p . --noEmit,以及 vp add -D tsrs 加 vpx tsrs --noEmit --fast,入口和时点都不同,别拼成一条命令混用。还有一条来自开发者实测的提醒:类型错误时 tsrs 的退出码是 2、tsc 是 1,接 CI 时可能改变脚本对成败的判断;这条 README 没写,只能按二手实测看待,自己接流水线前先验一遍。
「一夜写出编译器」这类说法该怎么读
仓库外还有一批更抓眼球的说法,得单独标清来源。「AI agent 一夜写出编译器」出自 Cloudflare 博客、InfoQ 与 Owner.com 的 Schwenk 自述:据 Schwenk 自述,他本人没写代码,由 Claude Opus 5.5 加 20 余个辅助 agent 一夜构建,以 TypeScript 官方 15,197 个一致性测试为规范;Owner.com 另称 37,000 文件的后端类型检查从单线程 80 秒降到流水线 7 秒,属企业自报。「Cloudflare 与 VoidZero 合作」、项目在 Oxc 工具链孵化,也都属仓库外宣传或旁证口径。这些可以写,但只能标「据某某报道」「据 Schwenk 自述」,不能写成项目官方定位,更不能拿来当标题定语;README 通篇没把这类生成方式写进定位,自我描述始终是那句替代实现。宣布日 2026-10-20 出自 flaviocopes 的记录(仓库外),VoidZero 十月回顾发布于 2026-11-05;而接口里的 created 是 2026-10-01,按 2026-11-08 的抓取时点,它早在 2026-10-01 就已建仓,写的人别把报道日当成建仓日。
现在能不能替换生产
把上面收一收,工程判断就不难下。第一,稳定版未发布,100% conformance 是 README 的 aim,不是验收结论;第二,docs/STATUS.md 里 beta 标签手动挂、版本仍是 beta 串,节奏还在预发布阶段;第三,PR 保持关闭、理由是没人力评审,外部贡献与修复的合入节奏不由社区推动;第四,三套提速数字彼此不能互证,别拿任何一组当「已经够快、可以换」的证据;第五,退出码差异这类细节还要自己验。合理的用法是:在旁路装一份,对自己的项目跑 --noEmit,比对诊断与耗时,把性能、内存、符合度上的问题提 issue 反馈,README 本来也是这么邀请读者的。不适合的是把它写进生产依赖或交付链路,更不该替项目宣布已经可以顶替 tsc。要等稳定版真正落地、100% conformance 有了可核的验收结果,再谈替换才站得住。3003 星说明关注度,不说明就绪度;一个把 PR 关着、把目标写清楚、把基准按来源分开的仓库,反倒比一组漂亮倍数更值得按事实去读。
常见问题
Q1:oxc-project/tsrs 到底是什么项目?
A1:它是用 Rust 写的 TypeScript 7 编译器与语言服务器替代实现,README 逐字写作 drop-in replacement for the TypeScript 7 compiler and language server, written in Rust。仓库在 GitHub 上的精确路径是 oxc-project/tsrs,按 2026-11-08T11:51:54Z 的接口快照为 3003 星、Rust、Apache-2.0。它目前处在 beta / 预发布,稳定版未发布。
Q2:3003 星是不是说明它已经稳定、能直接上生产?
A2:不是。3003 是 2026-11-08T11:51:54Z 的抓取快照,README 的 100% conformance 用的是 aim to,是目标;docs/STATUS.md 里仍是 0.23.0-ts7.1.0-beta 一类版本串、GitHub 预发布、npm beta 标签手动分配,没有 stable 已落地的记录。PR 还因人力不足保持关闭。星数是关注度,不是就绪度或稳定性承诺。
Q3:为什么能看到 8x、2.7x、5.3x 好几种不同的倍数?
A3:因为它们来自三套互不相干的口径:Cloudflare 官方博客的 up to 8x faster / ~70% less memory 对 TypeScript 7.0、属仓库外口径;仓库 bench/RESULTS.md 的项目方自测是 19 个项目、Apple M3 Max、2026-10-28、Hyperfine 中位数、对 7.1.0-beta,得 1.71x-6.62x faster 与 1.70x-2.75x less;第三方 ImportStatic 约 2.7x、Frank Chu 5.3x / -72% 又各有自己的机器与基线。基线版本、机器、方法、发布主体都不同,不能换算、不能相加,也不能拿一组解释另一组。
Q4:「AI agent 一夜写出编译器」是项目官方定位吗?
A4:不是。这出自 Cloudflare 博客、InfoQ 与 Owner.com 的 Schwenk 自述,据其自述由 Claude Opus 5.5 加 20 余个辅助 agent 构建、以 TypeScript 官方 15,197 个一致性测试为规范,属仓库外宣传或自述口径,只能标「据某某报道」「据 Schwenk 自述」。README 的官方定位是那句 drop-in replacement,没有把生成方式写进定位,也不该拿来当标题定语。
Q5:想试的话,从哪几条命令开始?
A5:按 README 是 pnpm add -D tsrs 装依赖,再 pnpm exec tsrs --noEmit --fast 跑一次不产出的类型检查,等价写法是 TSRS_FAST=1 pnpm exec tsrs --noEmit。仓库外资料另给 npm install -D tsrs 加 npx tsrs -p . --noEmit、以及 vp add -D tsrs 加 vpx tsrs --noEmit --fast,入口不同别混用。先在旁路项目比对诊断与耗时,别直接接进交付链路;类型错误时 tsrs 退出码是 2、tsc 是 1,接 CI 前先自验。