3天3740星的 rust-anything:故意改错一行 Rust,diff 能拦住吗
AI 帮你把 TypeScript 重写成 Rust 时,最怕的不是编译不过,而是「单测全绿、上线就崩」——尤其是空字符串、Unicode 大小写、预发布版本号这种边界细节。rust-anything 这两天在 GitHub 上冲到了 3740 星,主打的不是直接翻译代码,而是先录制原程序的行为基线,再拿同一批用例去 diff 你的 Rust 实现。
我在 Windows 本机(Node v24.11.0 + Rust 1.88.0)实测了 rust-anything 1.5.1,拿一个带 SemVer 解析和 slugify 的 TypeScript 模块跑通 analyze → bridge → record → build → diff → bench → gate。结果不仅拦住了我故意写错的一行 SemVer 比较逻辑,还顺手抓出了一个我写 Rust 时真没留神的 İstanbul Unicode 陷阱。
先说结论
| 环节 | 实测结果 | 关键发现 |
|---|---|---|
| 安装(Windows) | npm install rust-anything 3 秒就绪(1.5.1) |
源码 Cargo.toml 要求 rustc 1.97,本机 1.88.0 直接 cargo install 会卡版本门槛,npm 预编译包省事得多 |
| 桥接与编译 | 默认选 wasm-bindgen 缺 target 报错,切 --kind napi 一次编出 semver_rs.node |
普通 PowerShell 即可编译,无需手开 Developer PowerShell |
record + diff |
录制 715 条用例,711/715 匹配,精准拦下 4 条异常 | 不仅抓出故意埋错的 SemVer 逻辑,还顺带抓出 to_ascii_lowercase() 对 İstanbul 的差异 |
bench + gate |
bench 整体 0.56x(比原 JS 慢);cargo fmt 后 gate 11 项全绿 |
小函数单次跨 FFI 必亏,工具会直接劝退;要提速得连调用方一起迁或用 --batch |

背景
rust-anything 的思路很克制:它不负责把代码「翻译」成 Rust(写 Rust 还是交给你或你的 AI 编程助手),它负责提供迁移动作里最容易翻车的护栏——先通过 profile 和 analyze 找出热点与风险,再用 bridge 生成跨语言胶水代码和 src/port.rs 骨架,接着用 record 把原函数的返回值和抛错录成 cases.jsonl,最后靠 diff、bench 和 gate 验收。
实测:故意改错一行,看它怎么拦
1. 本机环境与安装
先核对本机工具链版本,并在独立工作目录通过 npm 安装 rust-anything(直接拉取官方预编译的 Windows 二进制):
node -v
cargo --version
rustc --version
npm install rust-anything
.\node_modules\.bin\rust-anything.cmd --version
实测输出:
v24.11.0
cargo 1.88.0 (873a06493 2025-05-10)
rustc 1.88.0 (6b00bc388 2025-06-23)
added 1 package, and audited 2 packages in 3s
rust-anything 1.5.1
这里有两个第一手细节值得记一下:一是 rust-anything 仓库里的 Cargo.toml 写了 rust-version = "1.97",如果你的本机和我一样是 1.88.0,直接跑 cargo install rust-anything 会卡在工具链版本上,用 npm 包是最快的;二是在 Windows PowerShell 下直接敲 .bin\rust-anything 会撞到无后缀 shim 没回显,带 .cmd 或直接调里面的 rust-anything.exe 才有完整输出。
2. 写一个带边界条件的 TypeScript 模块并做 analyze / bridge
我在临时项目 demo-app/src/semver.ts 写了三个带边界条件的函数:parseVersion(校验 v 前缀、缺段抛错、预发布标签)、compareVersions(SemVer 比较,要求 1.0.0-alpha < 1.0.0)和 slugify(截断后去掉末尾 -,maxLen <= 0 返回空串)。
先跑 analyze 看它的迁移评估:
rust-anything analyze .
输出摘要:
# Rust migration plan: demo-app (TypeScript/JavaScript)
1 packages, 1 source files (62 lines), 0 test files, 0 UI files, grouped into 1 units.
| # | Unit | Lines | Priority | Readiness | Tests | Bridge | Main risks |
| ---: | --- | ---: | ---: | ---: | ---: | --- | --- |
| 1 | `src/semver.ts` | 62 | 67 | 86 | 0 | wasm-bindgen | String offsets and slicing (5); Exceptions (4) |
因为是纯逻辑代码,analyze 默认推荐了 wasm-bindgen。我先顺着默认桥接试了一次 record + build,结果 record 顺利录出 702 条用例,但 build 因为本机没装 wasm32-unknown-unknown target 直接报错:
error[E0463]: can't find crate for `core`
= note: the `wasm32-unknown-unknown` target may not be installed
= help: consider downloading the target with `rustup target add wasm32-unknown-unknown`
改用 --kind napi 生成原生 Node 扩展,同时通过 --inputs inputs.jsonl 补入 13 条合法版本号业务用例(原因见下一节踩坑):
rust-anything bridge . src/semver.ts --kind napi
rust-anything record .\rust\semver-rs --inputs .\inputs.jsonl
rust-anything build .\rust\semver-rs
输出:
Created ...\demo-app\rust\semver-rs (Napi) for parseVersion, compareVersions, slugify
Recorded 715 cases (471 threw) in ...\demo-app\rust\semver-rs\cases.jsonl
compareVersions: 255
parseVersion: 225
slugify: 235
Regex traps (non-ASCII \w, \b and case folding) added for: parseVersion, compareVersions, slugify
Built ...\demo-app\rust\semver-rs\semver_rs.node
这次在 Windows 本机对比原代码与 Rust 端口的命令执行和输出核对,是通过 SpectrAI 会话里的终端工具逐条跑完并记录下来的。
3. 故意在 port.rs 埋错一行,跑 diff
在 rust/semver-rs/src/port.rs 里实现三个函数时,我在 compare_versions 故意漏掉「空 pre(正式版)大于非空 pre(预发布版)」的分支,直接按字符串比较:
if va.3 == vb.3 {
return Ok(0.0);
}
// 故意埋错:直接按字典序比,导致 "" < "alpha"
Ok(if va.3 > vb.3 { 1.0 } else { -1.0 })
同时在 slugify 里顺手写了 input.to_ascii_lowercase()。编译并运行 diff:
rust-anything build .\rust\semver-rs
rust-anything diff .\rust\semver-rs
原样输出:
Built ...\demo-app\rust\semver-rs\semver_rs.node
711/715 cases match
- slugify("İstanbul", 1000000): expected {"ok":"i-stanbul"}, got {"ok":"stanbul"}
- slugify("İstanbul", 1): expected {"ok":"i"}, got {"ok":"s"}
- compareVersions("1.0.0-alpha", "1.0.0"): expected {"ok":-1}, got {"ok":1}
- compareVersions("1.0.0", "1.0.0-alpha"): expected {"ok":1}, got {"ok":-1}
两条 compareVersions 的不匹配和我埋的 Bug 分毫不差;更意外的是上面两条 slugify("İstanbul", ...)——JS 的 toLowerCase() 会把土耳其语大写的 İ 转成 i\u0307,正则把组合点替换成 - 后得到 "i-stanbul",而我用 to_ascii_lowercase() 直接把非 ASCII 字符漏掉了。
4. 修复后重跑 diff、bench 与 gate
补上 va.3.is_empty() / vb.3.is_empty() 判断,并将 slugify 改为 input.to_lowercase() 后重跑:
rust-anything build .\rust\semver-rs
rust-anything diff .\rust\semver-rs
rust-anything bench .\rust\semver-rs
diff 输出 715/715 cases match,而 bench 给了一盆很清醒的冷水:
function cases orig ns/call Rust ns/call speedup
parseVersion 225 5875 9489 0.62x
compareVersions 255 6908 8535 0.81x
slugify 235 160 469 0.34x
Timed as callers call it, crossing included. Overall 0.56x (geometric mean); 0 of 3 functions at least 1.1x faster.
Do not ship this unit for speed: calling across costs more than the work these functions do. Port a bigger unit (these functions together with their callers), so one call does more work.
接着跑 rust-anything gate 时,前 10 项全绿,唯独 fmt 提示需要 cargo fmt。格式化后再跑一次 gate:
pass fmt formatted
pass clippy no warnings
pass cargo test passed
pass unsafe 2 unsafe uses, each with a `// SAFETY:` comment
pass ported nothing `unimplemented!` in port.rs
pass size 101 lines of Rust for 62 lines of TypeScript/JavaScript (1.6x)
pass error cases each of the 1 functions that fail in the original has a recorded failing case
pass panics no unwrap, expect or panic where the original returns an error
pass build built ...\demo-app\rust\semver-rs\semver_rs.node
pass api exports parseVersion, compareVersions, slugify
pass behavior 715/715 recorded cases match
Gate passed.
深入 / 踩坑:文档没展开的 4 个细节
- 纯靠自动
record测不到格式强约束的正常路径:在加--inputs之前,record自动生成的 702 个用例里,有 469 个都在抛错。随机字符和 Unicode 陷阱能很好地测试slugify和异常分支,但蒙不出"v1.2.3-beta.1"这种合法版本号。真实项目里一定要配合--inputs或--from-tests(挂现有单测)一起录。 - 默认
wasm-bindgenvs--kind napi:纯算法模块默认走 wasm,本机没装wasm32-unknown-unknown和wasm-bindgen-cli会直接卡在build;只在 Node 跑的话加--kind napi更省心。 - 小函数单次跨 FFI 一定会变慢:从
bench的数字能看得很清楚,slugify原版只要160 ns,跨一次 NAPI 边界就要469 ns。如果迁移完不看bench直接上线,反而把性能做负优化了。 gate不只看diff:哪怕715/715全匹配,只要代码没跑cargo fmt、clippy有警告、或者有unwrap()落在原函数抛错的路径上,gate一样会拦下来。
适用边界
- 只覆盖录到的路径:
diff和gate通过只代表「和已录制的用例一致」,未覆盖到的业务分支仍需人工或原有单测兜底。 - 不对比隐式副作用:除返回值、抛错、stdout/stderr 和显式支持的文件/HTTP 外,数据库状态、外部网络请求和并发时序不在对比范围内;官方也提醒
record会反复调用原函数,不要连生产库跑。 - 跨平台行为差异:录制结果只证明当前运行环境的表现(例如 Windows 与 Linux 下的路径分隔符或系统行为差异)。
浙公网安备 33010602011771号