erkamyaman/rust-anything
开发工具把 JavaScript、Python、C、Go、Ruby 或 Java 应用逐单元改写成 Rust,并用原版录制行为验证每一步。
项目介绍
rust-anything 面向的是增量迁移,而不是自动翻译。它先对原代码做性能剖析,确定先改哪些单元;然后生成桥接层和 Rust crate 骨架,记录原版在生成的边界用例和自定义输入上的输出,再把这些用例回放到 Rust 端口上比对。最后由 gate 检查格式化、clippy、unsafe、错误路径和未迁移部分是否都过关。Rust 代码由你或编码 Agent 编写,工具负责规划、脚手架和验证。
支持 TypeScript/JavaScript、Python、C、Go、Ruby 和 Java,覆盖 CLI、HTTP 服务和库。作者在文档中明确提示:按单个函数调用的 Rust 端口,跨桥开销可能抵消加速;真正有效的做法是用 profile 找到热循环,再用 --batch 把整段循环搬进 Rust。既可以按单元迁移,也可以借助 app front-door、app wire 和 app lift 走完整个应用。
快速使用
需要 Rust 工具链,以及被迁移语言的运行时(例如 TypeScript 需要 Node 22.6+,Python 3.9+,Go 1.21+,Ruby 3+,JDK 17+)。从 crates.io 安装并注册 Agent 集成:
cargo install rust-anything
rust-anything setup
setup 会向 Claude Code、Codex、Cursor 和 Gemini CLI 添加 MCP server 与工作流技能,修改现有配置文件前先保存备份。JavaScript 项目也可以 npm install -g rust-anything,或者从 GitHub Release 下载预编译二进制。
在项目内跑完整核心流程:
rust-anything profile . -- node bench.mjs
rust-anything analyze .
rust-anything bridge . src/fuzzy.ts --batch fuzzyScore:text
rust-anything record rust/fuzzy-rs
rust-anything build rust/fuzzy-rs
rust-anything diff rust/fuzzy-rs
rust-anything bench rust/fuzzy-rs
rust-anything gate rust/fuzzy-rs
在生成的 port.rs 中写 Rust 实现(或让 Agent 写),反复 diff 直到所有录制用例一致。各语言运行时要求和依赖见安装说明,各命令顺序的完整示例见自身使用流程。
使用约束
diff和gate通过,只证明录制覆盖到的行为一致。生产输入、未录制的副作用,以及时序、并发这类环境差异,都不在保证范围内。- 正则表达式是已知难点:Rust 的
regexcrate 不支持 lookaround 和反向引用,部分 Unicode 字符类、大小写匹配在即使能编译时也可能与 V8、Python 或 Java 不一致。JavaScript 的 UTF-16 字符串偏移也是常见差异来源。 - 数值代码可能需要
--float-tolerance,但整数、文本和结构仍必须完全一致。 - 部分构造无法跨桥,会留在原语言中,例如接收函数的 TypeScript 函数、生成器、正则值、
instanceof判断。这类情况下 fallback 比例降不到 0,app lift会拒绝执行。 - 工具不会自动改写代码;按单次调用迁移的小函数即使编译成 Rust,也可能比原版慢。
- 项目采用 MIT 许可;你在自己仓库中生成的端口代码归你所有。
HotRepo 点评
在 2026 年 11 月 17 日的新项目榜记录中,rust-anything 在一个约一小时的窗口里新增 89 Star,总数达到 200,Fork 为 15、新增 8。项目很新,窗口也短,这组数据只能说明早期关注度,不足以判断持续热度。更有分量的是 README 里的工程态度:x18n 案例如实记录了按单次调用迁移的端口比 TypeScript 更慢这一负面结果,也专门列出录制无法覆盖的差异来源。对正在做迁移决策的人来说,这种主动限定适用边界,比单纯宣传加速倍数更有参考价值。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
相关推荐
- addyosmani/agent-skills把资深工程师的规范、测试、评审与发布流程写成 Markdown 技能,让 AI 编程助手按步骤执行。
- juliobsz/skills一个 Agent skill,用一句话让 Claude Code 或 Codex 按获奖级流程建站并自评打分。
- samber/cc-skills-golang一组针对 Go 的 Agent Skills,让编程助手按 Go 惯用法写代码、测试和排错。
- Moh4696/open-3d-skills面向编码智能体的八项技能,用于构建、检查和录制 3D 与动画网站。
- caru-ini/stack-diagram把一句话的技术栈描述交给编码 Agent,生成带官方 logo 的架构图。