AIGC标识 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-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 个细节

  1. 纯靠自动 record 测不到格式强约束的正常路径:在加 --inputs 之前,record 自动生成的 702 个用例里,有 469 个都在抛错。随机字符和 Unicode 陷阱能很好地测试 slugify 和异常分支,但蒙不出 "v1.2.3-beta.1" 这种合法版本号。真实项目里一定要配合 --inputs 或 --from-tests(挂现有单测)一起录。
  2. 默认 wasm-bindgen vs --kind napi:纯算法模块默认走 wasm,本机没装 wasm32-unknown-unknown 和 wasm-bindgen-cli 会直接卡在 build;只在 Node 跑的话加 --kind napi 更省心。
  3. 小函数单次跨 FFI 一定会变慢:从 bench 的数字能看得很清楚,slugify 原版只要 160 ns,跨一次 NAPI 边界就要 469 ns。如果迁移完不看 bench 直接上线,反而把性能做负优化了。
  4. gate 不只看 diff:哪怕 715/715 全匹配,只要代码没跑 cargo fmt、clippy 有警告、或者有 unwrap() 落在原函数抛错的路径上,gate 一样会拦下来。

适用边界

  • 只覆盖录到的路径:diff 和 gate 通过只代表「和已录制的用例一致」,未覆盖到的业务分支仍需人工或原有单测兜底。
  • 不对比隐式副作用:除返回值、抛错、stdout/stderr 和显式支持的文件/HTTP 外,数据库状态、外部网络请求和并发时序不在对比范围内;官方也提醒 record 会反复调用原函数,不要连生产库跑。
  • 跨平台行为差异:录制结果只证明当前运行环境的表现(例如 Windows 与 Linux 下的路径分隔符或系统行为差异)。

迁移前检查清单

参考

posted @ 2026-11-19 14:46  SpectrAI光谱AI  阅读(19)  评论(0)    收藏  举报