网易首页 > 网易号 > 正文 申请入驻

GitHub 今日推荐|rust-anything

0
分享至

#GITHUB开源项目推荐#


一句话看懂

项目地址:https://github.com/erkamyaman/rust-anything

rust-anything 让你把 TypeScript、Python、Go、Java、Ruby、C 应用里的热点函数逐个重写成 Rust,工具会录制原函数的真实输入输出,Rust 版本写完后自动重放这些案例,列出所有不匹配项,直到行为完全一致才放行。从 crates.io 安装二进制后,一条命令就能生成带桥接代码的 Rust crate、测试案例清单和移植检查项。

它解决什么问题

性能瓶颈函数需要用 Rust 重写,但手工编写 FFI 绑定繁琐,更难保证新旧版本行为完全一致。全量翻译工具会生成大段机器代码,难以维护。

rust-anything 提供剖析、桥接、录制、对比、门禁五步流程。剖析阶段调用语言原生 profiler,列出热点函数和调用者。桥接阶段生成 Rust crate 骨架,包含 napi-rs 或 PyO3 绑定层、带unimplemented!占位的 port.rs 桩函数、rust-anything.json 清单。录制阶段在边界值和语义陷阱上运行原函数,将输入、输出、异常保存为 cases.jsonl。对比阶段重放所有案例到 Rust 实现,列出返回值或异常不匹配的项。门禁阶段检查 fmt、clippy -D warnings、测试、unsafe 审计、API 签名、行为一致性六项标准,全部通过后才算移植完成。

官方案例:x18n 搜索 50000 键查询从 10 毫秒降至 0.5 毫秒,加速 20 倍;Python slugify 加速 17 倍。

核心概念速览

bridge:生成 Rust crate 骨架和语言绑定,让原语言代码能调用 Rust。对应rust-anything bridge命令,生成 lib.rs 绑定层、port.rs 移植桩、rust-anything.json 清单。

record:运行原代码记录输入输出和异常,保存为 cases.jsonl。工具在边界值和语义陷阱上执行原函数,生成验证基准。

diff:重放录制案例到 Rust 实现,列出不匹配项,确保返回值、异常类型、浮点容差一致。

gate:通过检查项清单,判定移植是否完成。检查 fmt、clippy、测试、unsafe、API、行为等六项标准,任一项失败都会阻止放行。

Manifest:rust-anything.json 清单文件,记录源单元路径、语言、导出函数签名、批处理配置、浮点容差。

架构拆解


rust-anything 分为剖析、桥接、代码生成、录制对比四个模块。

profile 模块(src/profile.rs)运行工作负载,调用语言原生 profiler,返回热点函数列表和移植建议。对于已被 numba、Cython、JAX 编译的 Python 函数,profile 标注"Already compiled... unlikely to run it much faster"。对于叶函数,警告"Porting a leaf function rarely pays: each call into Rust costs more"。

bridge 模块(src/bridge.rs)生成 Rust crate 脚手架。Manifest 结构体定义 rust-anything.json 字段:root 指向源项目根目录,unit 是源文件路径,language 标识语言,exports 列出导出函数签名,batches 存放批处理配置,float_tolerance 指定浮点对比容差。

codegen 模块(src/codegen.rs)从 TypeScript 签名生成 port.rs 桩,从 port.rs 生成 lib.rs 绑定。port_rs 函数为每个导出函数生成带unimplemented!占位的桩函数,参数名转为 snake_case,类型映射到 Rust 类型。生成的 port.rs 顶部禁止 unsafe_code。

录制对比流程:record命令在边界值上运行原代码,写入 cases.jsonl;diff命令重放案例到 Rust,列出不匹配项;bench命令测量性能差异;gate命令检查六项标准。

关键实现走读生成 port.rs 桩函数

pub fn port_rs(m: &Manifest) -> String {let mut out = format!("//! The Rust port of `{}`.\n//!\n\//! Replace each `unimplemented!` with the port of the source function. Return `Err` where\n\//! the source throws or raises: the caller gets an error there too. After changing a\n\//! signature, run `rust-anything refresh` to regenerate the bindings. `rust-anything diff` checks\n\//! behavior against what the source recorded.\n\n\#![forbid(unsafe_code)]\n",m.unitfor f in &m.exports {let params = f.params.iter().map(|p| format!("{}: {}", snake_case(&p.name), port_param_type(m, p).rust())).collect::>().join(", ");

codegen 模块的 port_rs 函数读取 Manifest,为每个导出函数生成带类型签名的 Rust 桩函数。顶部添加禁止 unsafe_code 编译器指令,参数名转为 snake_case。禁止 unsafe_code 确保移植代码无内存安全隐患,与 Cargo.toml 的 lints.rust.unsafe_code = "forbid" 配置一致。

Manifest 清单结构

#[derive(Clone, Debug, Serialize, Deserialize)]pub struct Manifest {pub schema: String,pub root: PathBuf,#[serde(skip)]pub root_written: Option,pub unit: String,#[serde(default)]pub language: crate::lang::Lang,pub kind: Kind,pub crate_name: String,pub exports: Vec,#[serde(default)]pub classes: Vec,#[serde(default)]pub js_only: Vec,#[serde(default, skip_serializing_if = "Vec::is_empty")]pub batches: Vec,#[serde(default, skip_serializing_if = "Option::is_none")]pub float_tolerance: Option,

Manifest 定义 rust-anything.json 完整字段。root 指向源项目根目录,unit 是待移植源文件路径,language 标识六种支持语言,exports 列出导出函数签名和参数类型,batches 存放批处理配置,float_tolerance 指定浮点对比容差。float_tolerance 字段体现对浮点语义的理解,JavaScript 和 Python 浮点运算在不同 CPU 或编译器优化下可能产生微小差异,严格相等比较会误报。

动手上手


安装 rust-anything 二进制,需要 Rust 1.97 或更高版本:

cargo install rust-anything

或通过 npm 安装预构建二进制:

npm install -g rust-anything

剖析项目热点:

rust-anything profile . -- node bench.mjs

为 src/fuzzy.ts 的 fuzzyScore 函数生成桥接 crate:

rust-anything bridge . src/fuzzy.ts --batch fuzzyScore:text

在当前目录生成 rust/fuzzy-rs 目录,包含 Cargo.toml、src/lib.rs(napi-rs 绑定)、src/port.rs(带unimplemented!的桩函数)、rust-anything.json(清单)。

录制原函数行为:

rust-anything record rust/fuzzy-rs && rust-anything build rust/fuzzy-rs

生成 cases.jsonl,每行记录一个输入输出对,包含边界值和语义陷阱测试用例。

在 rust/fuzzy-rs/src/port.rs 里填充实际 Rust 逻辑后,重新构建并对比:

rust-anything diff rust/fuzzy-rs

重放 cases.jsonl 所有案例,列出返回值或异常不匹配项。

测量性能提升:

rust-anything bench rust/fuzzy-rs

输出原函数和 Rust 版本在相同输入下的执行时间,显示加速倍数。

运行门禁检查:

rust-anything gate rust/fuzzy-rs

输出 fmt、clippy -D warnings、tests、unsafe audit、API、behavior 六项检查结果,全部通过后显示绿色"Gate passed"。

应用场景

热点函数加速:profile 找到性能瓶颈后,bridge 该函数生成桥接 crate,record 录制行为,开发者或 AI 编写 Rust 逻辑,diff 通过后在原代码切换到 Rust 实现。适合字符串处理、搜索、序列化等计算密集场景。

完整应用分阶段迁移:对大型代码库,按热点排序逐单元 bridge,每个单元通过 gate 后再移植下一个。限制是只能验证已录制路径,未覆盖的边界或异常案例不被捕获。

批处理类加速循环:bridge 使用 --batch 参数生成批处理类,数据驻留 Rust 侧,跨所有核并行处理。原代码逐次调用改为一次传入数组,Rust 用 rayon 并行。适合大批量数据转换、图像处理、日志解析等能批量化的任务。

独立分析


rust-anything 解决的核心问题是渐进式迁移中的行为验证。传统手工重写需要自己编写 FFI 绑定代码,类型映射容易出错。更大的问题是验证:手工写单元测试覆盖所有边界情况工作量大,很难保证新旧版本在极端输入下行为一致。rust-anything 通过录制真实工作负载的输入输出,自动生成测试基准,把行为验证从人工编写测试变成自动重放对比。

与全量翻译工具的区别是定位。全量工具试图把整个文件翻译成 Rust,生成的代码可读性差,难以维护。rust-anything 不翻译代码,只生成桥接层和测试案例,实际 Rust 逻辑由开发者或 AI 编写。profile 模块给出的移植建议(叶函数成本高、已编译函数收益低)体现工具不追求全量迁移,而是帮助开发者判断哪些单元值得移植。

与 JIT 编译器(PyPy、numba)的对比在于控制粒度和部署复杂度。JIT 编译器需要运行时支持,numba 限制 Python 子集,PyPy 与 C 扩展兼容性差。rust-anything 生成的是原生库,无运行时依赖,可以在任何 Python 或 Node.js 环境部署。

门禁机制是工具的关键设计。fmt、clippy -D warnings、unsafe audit 三项检查强制代码质量,禁止 unsafe_code 的配置写在 Cargo.toml 和生成的 port.rs 顶部,确保移植代码无内存安全隐患。behavior 检查是最后防线,所有录制案例必须匹配才能通过。

batches 功能针对批处理场景优化。逐次跨 FFI 调用的开销在大批量数据下会成为瓶颈,batches 配置让数据驻留 Rust 侧,用 rayon 并行处理。这种设计需要修改调用方 API,是有意识的权衡。

局限与风险

record 只能捕获已录制行为,未覆盖的代码路径或边界案例不被 diff 验证。如果原函数有复杂分支逻辑,record 阶段的输入集合没有触发某些分支,Rust 移植后这些分支的行为差异不会被发现。

profile 模块指出极小函数单次调用移植到 Rust 可能比 JIT 更慢。Node.js 的 V8 和 Python 的 PyPy 在热代码路径上能达到接近原生的性能,单次跨 FFI 调用有固定开销,微小函数执行时间可能小于这个开销。

PHP 和 C# 处于预览阶段,只支持整应用录制重放,单函数 FFI 桥接尚未完成。

gate 的 unsafe audit 只检查是否存在 unsafe 代码块,对于依赖的第三方 crate 是否安全不做审计。生产环境使用前需要人工 review 生成的绑定代码。

batches 配置改变了调用方 API,从逐次调用改为传入数组。如果原函数有副作用(写文件、发网络请求),批处理模式下副作用顺序可能与逐次调用不同,diff 阶段无法捕获这类语义差异。

结论卡片


适合这个工具:需要将现有 TypeScript、Python、Go、Java、Ruby、C 业务逻辑迁移到 Rust,要求性能提升且必须保证行为与原函数完全一致的团队。已有成熟代码库,profile 能识别出明确热点,移植后能在原项目无缝替换的场景。配合 AI 编码助手使用,工具生成桥接和测试,AI 填充 Rust 逻辑,人工验收 gate 结果。

不适合这个工具:全新项目,没有遗留代码需要迁移。对已被 JIT 优化的微小函数单独加速,单次调用开销可能抵消收益。需要迁移 PHP 或 C# 项目且要求单函数 FFI 桥接,当前预览版本不支持。

后续行动:先运行 profile 确认热点函数和移植收益预估,避免在叶函数或已编译函数上浪费时间。选择一个独立的热点单元作为试点,走完 bridge、record、port、diff、gate 流程,实测性能提升和行为一致性。试点成功后再扩展到更多单元,逐步替换原应用的性能瓶颈。

项目地址:https://github.com/erkamyaman/rust-anything

特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。

Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.

相关推荐
热点推荐
王毅和夫人钱韦罕见同框,不怒自威与和蔼可亲,和老丈人一脉相承

王毅和夫人钱韦罕见同框,不怒自威与和蔼可亲,和老丈人一脉相承

李昕言温度空间
2026-06-06 20:57:13
篮球女神官宣离婚!千字长文控诉丈夫,无出轨无家暴是扎心的地方

篮球女神官宣离婚!千字长文控诉丈夫,无出轨无家暴是扎心的地方

手工制作阿歼
2026-11-19 07:38:05
收视率几乎为0,县城电视台为什么还没关?

收视率几乎为0,县城电视台为什么还没关?

罗sir财话
2026-11-15 12:56:18
22岁女大学生嫁60岁沙特王子,每天雷打不动5次夫妻生活,陪他走过11年,临终前他却把457亿家产留初恋,她平静一笑:有个秘密我藏了11年

22岁女大学生嫁60岁沙特王子,每天雷打不动5次夫妻生活,陪他走过11年,临终前他却把457亿家产留初恋,她平静一笑:有个秘密我藏了11年

温柔记事簿
2026-11-18 19:12:38
阿卡晋级:不能怪梅总“梦游”,无敌的阿卡太强,医暂留下隐忧

阿卡晋级:不能怪梅总“梦游”,无敌的阿卡太强,医暂留下隐忧

网球之家
2026-11-18 23:18:23
《GTA6》首个地区正式上线!全球首发 见证历史

《GTA6》首个地区正式上线!全球首发 见证历史

游民星空
2026-11-18 19:11:14
道指跌幅扩大至1%

道指跌幅扩大至1%

每日经济新闻
2026-11-18 22:55:04
新华社消息|外交部:中俄美元首将就事关全球和平的重要问题深入交换意见

新华社消息|外交部:中俄美元首将就事关全球和平的重要问题深入交换意见

新华社
2026-11-18 15:44:19
事出诡异!加拿大中国领馆外反常集会,一群人高喊"中国收复藏南"

事出诡异!加拿大中国领馆外反常集会,一群人高喊"中国收复藏南"

锅锅爱历史
2026-11-04 09:43:53
抢在中美俄会晤前!高市堵特朗普,白宫一句没必要,日本要跑空

抢在中美俄会晤前!高市堵特朗普,白宫一句没必要,日本要跑空

漫步独行侠
2026-11-18 09:55:01
事关台湾问题,特朗普与高市早苗都表态了,俄外长猛批西方一立场

事关台湾问题,特朗普与高市早苗都表态了,俄外长猛批西方一立场

鸟儿太能吃
2026-11-18 22:51:00
美国记者惊呼:中国已成全球顶流!美国青年正经历中国化转变?

美国记者惊呼:中国已成全球顶流!美国青年正经历中国化转变?

科普启示录小强哥
2026-11-14 19:50:07
闯王来了不纳粮?那几十万大军的饭,到底是谁在买单?

闯王来了不纳粮?那几十万大军的饭,到底是谁在买单?

迷世书童
2026-11-16 09:34:31
8万亿,一个人说了算

8万亿,一个人说了算

价值罗盘
2026-10-28 22:55:13
皇马欧冠功臣因伤缺阵超1000天,本季0出场

皇马欧冠功臣因伤缺阵超1000天,本季0出场

寒律
2026-11-18 16:52:15
目前,全球还存在着7个流亡政府,他们还有希望复国吗?

目前,全球还存在着7个流亡政府,他们还有希望复国吗?

七号说三国
2026-11-05 19:09:34
美特使警告俄:和平协议抓紧签,明年民主党掌控国会,条件恐生变

美特使警告俄:和平协议抓紧签,明年民主党掌控国会,条件恐生变

桂系007
2026-11-19 02:57:38
此人主政中国最大省长达20年,晚年升任副主席掌权中枢,8个子女都是栋梁之才

此人主政中国最大省长达20年,晚年升任副主席掌权中枢,8个子女都是栋梁之才

磊子讲史
2026-11-18 14:30:02
日本人发现中国一个规律:中国人可以低头学技术但不会安心附庸。

日本人发现中国一个规律:中国人可以低头学技术但不会安心附庸。

江启
2026-11-10 11:57:30
消失已久的赖昌星侄子赖文峰又露面,这次不是带货,而是为杨钰莹

消失已久的赖昌星侄子赖文峰又露面,这次不是带货,而是为杨钰莹

侦姐有料
2025-06-08 12:07:04
2026-11-19 08:12:49
呼呼历史论
呼呼历史论
分享有趣的历史
780文章数 18731关注度
往期回顾 全部

科技要闻

离职后首份声明!黄仁勋认错愿回归

头条要闻

欢迎晚宴合影期间 普京与特朗普握手交流

头条要闻

欢迎晚宴合影期间 普京与特朗普握手交流

体育要闻

“中超卡里乌斯”,成了大连的夺冠英雄

娱乐要闻

主持人张泉灵被曝猛料,公司成老赖

财经要闻

黄仁勋留下的高分成绩单,能延续吗?

汽车要闻

全新红旗H9最有意思的地方,是它开始有自己的豪华逻辑了

态度原创

手机
亲子
艺术
公开课
军事航空

手机要闻

苹果自家App Store终于适配iPhone Duo,铰链屏裂事件又有新进展

亲子要闻

这个小面迟早要在两岁之前,测评完沈阳所有商场啊

艺术要闻

洛阳发现唐代墓志,将魏碑、唐楷精髓融于一体,比欧颜柳赵的字更耐看!

公开课

李玫瑾:为什么性格比能力更重要?

军事要闻

美军再袭伊朗格什姆岛

无障碍浏览 进入关怀版