GitHub 热门项目推荐:rust-anything(Rust|5197 Star)

这个项目有什么用

rust-anything 是一个把现有应用逐步改写成 Rust 的工具。它先记录原应用在边界用例、语义陷阱和自定义输入下的真实行为,再让每一块 Rust 重写都对照这份记录做校验,直到整个应用变成纯 Rust。它面向 Node.js(TypeScript/JavaScript)、Python、C、Go、Ruby、Java、Kotlin 等语言编写的 CLI、HTTP 服务和库。

它替代的不是「翻译代码」这件事本身,而是围绕迁移的一系列手工操作:靠猜判断性能热点、手动设计 FFI 桥接层、凭经验判断重写是否等价、以及缺少一个明确的「可以上线了」的判定标准。

典型使用场景

  • 想把一个 Node.js 或 Python 服务里最慢的热点路径换成 Rust,但不想一次性重写整个项目。
  • 想整体迁移一个 CLI 工具或 HTTP 服务,同时保证输出与原实现逐字节一致。
  • 团队里有 coding agent(如 Claude Code、Codex、Cursor、OpenCode),希望由 agent 来写 Rust,而工具负责提供行为基准与验收门禁。

适合愿意接受「先记录、再重写、后校验」流程的开发者与团队;不适合期望工具自动完成代码翻译的人——README 明确说明 rust-anything 不翻译代码,Rust 由你的 coding agent 或你自己来写。

核心特性

  • 四步闭环:Record / Port / Check / Lift。 record 在原应用上跑生成的边界用例、语义陷阱和你的输入,保存返回值或抛出的异常;bridge 生成 Rust crate 和 wrapper,让调用方保持原 API 不变;diff 回放全部记录用例;全部匹配且 gate 通过后,app lift 才把它变成纯 Rust 应用,且原应用始终不被改动。
  • 可增量迁移。 可以整工具、整服务迁移,也可以只迁移一条热点路径,一块一块推进。
  • 不止比对返回值。 除了输出,还能用 app record --effects 记录应用发出的副作用,避免出现「输出一样但邮件发了两遍」这类重写事故。
  • 多语言桥接与批量接口。 除 C 以外的语言都提供 batch classes(--batch),数据一次性跨语言边界后留在 Rust 中,每次调用在所有核心上并行处理全部条目。
  • 类型来源取自源码。 支持 TS 类型、Python hints、C/Go/Java/Kotlin/C# 签名、Ruby YARD 标签、PHP 类型与 phpdoc;未标注类型但被当数字使用的参数会被推断为数字。
  • 真实项目验证。 README 给出的例子是 Prettier 的 Rust 移植:17,224 条记录运行全部与 Prettier 逐字节一致,其中 15,837 条完全由 Rust 完成,未移植部分回退到 Prettier;另有 json-server 的 514/514 条 HTTP 用例在纯 Rust 二进制上匹配。

怎么安装

README 摘录中没有独立的安装章节,官方文档未说明具体安装步骤与版本前提。从仓库信息看,项目主语言为 Rust,同时在 npm 上发布了包(项目主页为 https://www.npmjs.com/package/rust-anything),因此通常可以从 npm 获取。具体安装方式请以官方文档为准,本文不做推测。

若使用 OpenCode,README 给出了手工接入方式:把 server 写入 ~/.config/opencode/opencode.json(其中 command 是完整的 argv),并把 skills/rust-anything/ 复制到 ~/.config/opencode/skills/rust-anything/:

{
  "mcp": {
    "servers": {
      "rust-anything": { "type": "local", "command": ["rust-anything", "mcp"] }
    }
  }
}

另外,setup 在修改已存在的文件前,会在其旁边保存一份副本(.rust-anything.bak)。

怎么使用

最直接的方式是手动执行各步骤。README 给出的示例流程如下:

rust-anything profile . -- node bench.mjs              # what is hot, and who calls it
rust-anything bridge . src/fuzzy.ts --batch fuzzyScore:text
# write src/port.rs (or let your agent), then:
rust-anything record rust/fuzzy-rs && rust-anything build rust/fuzzy-rs
rust-anything diff rust/fuzzy-rs                       # every recorded case must match
rust-anything bench rust/fuzzy-rs                      # faster? the verdict says
rust-anything gate rust/fuzzy-rs                       # done means this passes

流程含义:先用 profile 找出热点与调用关系,用 bridge 生成桥接,然后写 Rust(或交给 agent),接着 record + build、diff 回放校验、bench 看是否更快,最后 gate 作为完成判定。

进阶用法

  • 语言检测默认从仓库文件推断(如 go.mod、pom.xml、build.gradle/build.gradle.kts、.csproj 或 .sln、pyproject.toml、Gemfile、composer.json、package.json,否则取最常见的源文件),可用 --lang 覆盖。
  • Android 场景可用 rust-anything build <name> --profile android 借助 NDK 构建同一份 JNI 库,安装到 /jniLibs/<abi>/;--api 设置 API level(最低 26),--abi 可指定 ABI。NDK 会从 ANDROID_NDK_HOME/ANDROID_NDK_ROOT 或 SDK 中查找,并需要先执行 rustup target add aarch64-linux-android armv7-linux-androideabi x86_64-linux-android。多设备连接时需用 --device <serial> 指定设备。

适用场景与注意事项

适合:想以可控节奏把 Node.js、Python、C、Go、Ruby、Java、Kotlin 项目迁移到 Rust 的团队;希望用行为记录而非人工比对来验收重写的场景;已有 coding agent、需要工具补齐「热点定位、桥接生成、行为基准、验收门禁」的团队。

不适合:期待工具直接翻译代码的人;以及行为无法被记录覆盖的部分——README 明确说明它只能捕捉记录所覆盖的内容,并指向 docs/how-it-works.md#what-it-cant-catch 说明局限。

  • README 提到「每次调用只调一个小函数通常比 JIT 更慢」,工具的价值在于找出值得迁移的循环,而不是盲目把函数搬进 Rust。
  • Android 的 profile 只覆盖逻辑单元:Activity/Compose/XML UI、生命周期和 SDK 专属类仍留在 Kotlin,且每次调用都跨 JNI,热循环建议使用生成的 batch wrapper。该流程需要 adb、设备、kotlinc 以及带 build-tools 和 platform 的 SDK。
  • PHP 与 C# 目前支持 analyze 规划、记录与回放、以及 Rust 前门,把单元通过 FFI / P/Invoke 移植到 Rust 是后续计划(README 指向 issue #2)。
  • 许可证为 MIT。

项目地址

仓库地址:https://github.com/erkamyaman/rust-anything
作者/组织:erkamyaman
项目主页:https://www.npmjs.com/package/rust-anything

总体而言,rust-anything 把「重写为 Rust」拆成可记录、可回放、可判定完成的步骤,适合需要以行为一致性为前提做渐进式迁移的团队参考使用。

© 版权声明
THE END
喜欢就支持一下吧
点赞9 分享