跳到主要内容

Nudo vs TypeScript

代码理解、健壮性、语言延续——这三类需求如何在 Nudo 与 TypeScript 之间取舍,是本页要回答的问题。

相关:从 TypeScript 迁移 · 为什么选 Nudo · 错误对照。

Nudo 的目标是:替代 TypeScript 作为日常类型检查门禁,而非复刻 TypeScript 编译器。双门并行仅是迁移期手段,出口是 nudo migrate retire。现有代码是 JS 还是 TS,不是选型理由——Nudo 可分析 TS(剥离标注后按 JS 语义),并提供 migrate 单向迁移。下文按竞争维度说明替代如何成立,以及引擎的范围边界。

定位​

TypeScriptNudo
主表面.ts + 类型标注普通 .js(传入 .ts 时剥离类型语法)
类型模型声明式结构类型Abs(shape × term × pred × conf),可计算类型
契约interface / type 语言*.nudo.js 构建器(fn / shape / number().gt(0))+ 可选 @nudo:contract
推断标注 + 局部推断在符号 Abs 上执行代码(evaluator)
检查诊断tsc --noEmitnudo check(Abs 上 actual ⊭ expected;成功亦打印 signatures)
生态出口.d.ts 即模型.d.ts 为有损投影(absToTSType),非真源
退出对方—nudo migrate → retire tsc

目标不是「在 JS 上书写 TS 语法」,而是:JavaScript 保持为 JavaScript;义务来自显式契约(L1)与 JS 运行时导出边界(L2 入口 throws);引擎以求值推理,不引入第二套类型语言。

与 TypeScript 设计目标的关系​

Microsoft 的 TypeScript Design Goals 明确列出两条非目标,恰好落在 Nudo 的主轴上:

Apply a sound or "provably correct" type system. Instead, strike a balance between correctness and productivity.

Add or rely on run-time type information in programs, or emit different code based on the results of the type system. Instead, encourage programming patterns that do not require run-time metadata.

因此 throws 轴(L2 入口 may-throw)与 Pred 轴(Abs 上的约束蕴含)按设计不在 TypeScript 路线图内。Nudo 取互补范围。相对 Flow、Hegel、schema 库与 refinement types 的完整地图:竞争格局。

目标TypeScriptNudo
理解代码源码标注 / IDE hover 显示声明类型check 签名与逐变量推导;调用点证据
检查诊断tsc --noEmitnudo check(成功亦打印 signatures)
入口安全any.prop 不报错入口对 any 的危险操作进入 throws 域;L2 可报 error
违例形态“Not assignable to type …”actual / expected / fix:

替代发生在哪些维度​

选型比较的是开发体验与事实质量,不是仓库里文件的后缀:

维度TypeScriptNudo
注解负担逻辑与类型语言并行书写逻辑保持 JS;契约按需,且可用 contract --draft 起草
观察粒度声明类型名逐变量接近运行时的值 / 形状 / 约束
约束表达结构类型为主(number)可计算 Pred(ms > 0、返回 > 0)
语义来源标注 + 局部推断在 Abs 上执行;调用点是证据
错误形态“Not assignable to type …”actual / expected / fix:
真源源码标注Abs;.d.ts 等为有损投影
编辑路径成本全程序结构类型常驻(tsserver)单文件 / 脏集 Abs 求值;内存有界
Agent 循环成本叙述式诊断;全工程多轮结构化 actions[];门禁载荷更省(见下)
迁移成本—migrate status → strip → verify → retire

契约可以先声明(侧车 / @nudo:contract),也可从代码生成草稿再人工收紧;声明面比 interface 更精确(含数值与形状约束)。「先写类型还是先写逻辑」不是 TS 与 Nudo 的分野。

性能、token 与内存​

完整的对照测试尚未齐备。方向已由架构与仓库内既有实测确立;下表数字是待扩大的基线,不是封闭的基准结论。

成本结构为何偏向 Nudo​

因素TypeScriptNudo
常驻什么全 Program 结构类型——任一跨文件形状都可能改写结论单文件 Abs 结果 + 轻量记账;关文件即丢分析
编辑路径语言服务 / 工程刷新脏集重分析;单文件 analyzeFile / checkSource
Agent 要读什么类型名叙述(“Not assignable to type …”)actual / expected / actions[]——修复轮次更少
作者要写什么标注 + 类型层编程契约按需;源码中无第二套语言

已有实测​

探针NudoTypeScript说明
单文件实时编辑analyzeFile 0.19 ms,checkSource 0.39 ms 中位benchmark/micro/bench-vs-tsc 中 tsc.LS 量级 10 ms+(微基准约 150×)合成 monorepo / 微负载;见性能 · S1 基线报告
Agent 修复(node-semver 历史 bug,约 2.4k LOC)tokenTotal 569k · 轮次 45 · 修复环 16 · 门禁峰值 RSS 226 MB993k(+75%)· 63 · 21 · 289 MB两侧均 6/6 完成;差距在成本而非检出上限——OSS-SEMVER 报告
约束类门禁载荷能检出;token 花在报告上常假绿(不花 token,缺陷放行)pnpm run agent-dx——TS 的「便宜 token」往往是沉默

宣称边界​

  • 微基准与 S1 语料为合成;OSS-SEMVER 仅是单一真实包族。绝对 SLO 需要更广套件。
  • 峰值 RSS 是 agent 循环中的门禁进程 RSS,不是 IDE 稳态常驻。
  • 内存优势是结构性的(不要求全程序常驻),并体现在 LSP 有界会话模型;同一编辑器负载下 tsserver 长跑堆与 Nudo LSP 的对照矩阵尚未发布。

Nudo 一侧的性能实务——预算、截断诊断与分析缓存——见性能。

能力边界(引擎非目标)​

以下能力是 Nudo 引擎的非目标,与「某个业务包是否应长期以 tsc 作门禁」不是同一个问题:

  1. 完整 TS 类型语言编程:条件类型、模板字面量类型编程、映射类型等作为编程手段——表面就是这类工作的包保留手写声明即可:保留手写 .d.ts。
  2. 与 tsc 可赋值性逐位一致:Nudo 的门禁是 Abs 上的 Pred 蕴含与部分 leqAbs。
  3. declaration merging / project references 作为产品 IR:不复刻 TypeScript 工程模型。
  4. 健全性证明:不承诺 soundness,也不以「更严的类型系统」与 TS 正面比较。

若产品本身就是类型语言(编写类型体操库、维护 DefinitelyTyped 式声明表面),TypeScript 是该工作的工具。对常规业务逻辑与工具包,检查门禁的终点仍是 nudo check + migrate retire,而不是永久双门。

「替代 TypeScript」的具体含义​

对单个包,完整替代清单:

能力Nudo 路径
打开普通 .js 获得 hover / inlayLSP + package.json#nudo.analysis.mode(默认 exports;可选 all / directives)
观察层观察nudo check 签名(无 infer 动词)
检查门禁nudo check — error 级诊断退出码 1(L1 + 未 ignore 的 L2);可接入本地或自动化流程
显式契约*.nudo.js + @nudo:contract;手写即 L1 义务
生成事实nudo contract --emit → @generated 段(drift 记录,不静默改写义务)
npm / 编辑器类型nudo export --format dts — 单向投影
退出 tscnudo migrate status → strip → verify → retire
性能基准仓库 benchmark + benchmark:gate — 同一 case 集合规模;精确回归超过 1-case 抖动、unknown / error 计数上升、逐 case 顺序劣于基线、或均值 > 3.0× 基线时失败

不宣称:一键迁移任意规模的 TS monorepo;以完整结构类型为主模型;第二套 IR;与 tsc 逐位同语义。

对照示例​

TypeScript(声明式):

export function needsPositive(x: number): number {
return x > 0 ? x : 0;
}
needsPositive(-1); // tsc 允许

Nudo(契约 + 诊断):

/// @nudo:import { positive } from "./shapes.nudo.js"

/**
* @nudo:contract x positive
*/
export function needsPositive(x) {
return x > 0 ? x : 0;
}

needsPositive(-1);
// nudo check → nudo:constraint-violated
// actual: -1 #exact
// expected: x > 0

TypeScript 将意图写入签名;Nudo 将同一义务编码为可计算约束,并在调用点给出违例。两者皆合法;仅后者不依赖类型语言。更多形态:错误对照;十个可运行场景(输出已钉住):错误信息对照。

迁移,而非永久双门​

Monorepo 中按包迁移,随后退出:

npx nudojs migrate status packages/tool
npx nudojs migrate strip packages/tool/src --write
npx nudojs migrate verify packages/tool/src
npx nudojs migrate retire packages/tool

迁移期内的短期双跑是手段,不是终态——见共存。产品终态是单一门禁:nudo check。

相关​