fast-anything 找出程式中最慢的部分,只把那段改寫成 Rust
Fast-Anything: Don't rewrite it in Rust. Rewrite the 5% that's slow
整個程式改寫成 Rust 可能要花好幾個月,但拖慢速度的工作往往集中在少數函式。
- fast-anything 會先找出最耗時的部分,再請 AI 助理把選中的函式改寫成 Rust,並用程式實際跑過的資料比對結果。
- 確認結果一致,而且整體執行更快後,才會啟用新版。工具也能隨時切回原本程式。作者列出多種語言的測試結果,例如 Python 名單比對從 4.91 秒降到 42 毫秒。
- 這些數字來自作者提供的測試環境與範例。
AI 伴隨問答
針對這篇報導有疑問?可直接點選快捷問題或向 AI 追問背景脈絡與技術細節:
工具會先找出最耗時的函式,再用實際呼叫比對 Rust 版本,讓開發者評估區域性改寫是否能加速整個程式。
別用 Rust 重寫整個程式,只重寫最慢的 5%。
用 Rust 重寫整個應用程式,要花上好幾個月,編譯時間以分鐘計,還會產生數 GB 的 target/。不過,大部分執行時間通常都耗在少數幾個函式上。
fast-anything 會找出這些函式,讓你的程式碼代理只把這些函式移植到 Rust,再用實際錄製的呼叫確認移植前後結果相同,最後替換原本的程式碼。一個指令即可完成,而且隨時都能完整還原。
安裝
npm i -g @el4cteo/fast-anything # or: cargo install fast-anything移植後的程式會使用你的 Rust 工具鏈編譯(rustup)。
使用
fast-anything go --agent claude -- python app.py # or: -- node app.ts / bun app.ts / deno run -A app.ts / ruby app.rb / java App.java / mvn exec:java / gradle run / go run . / php app.php / clang -O2 main.c也可以依照以下步驟操作:
| 指令 | 用途 |
|---|---|
scan -- <cmd> |
分析應用程式,依照執行時間 × 可移植性排列函式 |
port [id] |
最多錄製 500 次實際呼叫,建立只含一個函式的 Rust crate 和 TASK.md |
verify |
以 release 模式建置移植版本,並重播所有錄製的呼叫 |
enable / disable |
切換使用 Rust 版本或原始版本(只替換一個標記區塊,移除時逐位元組還原) |
bench |
交錯執行原始版本與 Rust 版本,測量整個應用程式的執行時間 |
report |
產生 Markdown 和 SVG 卡片,供你放進 PR |
doctor |
檢查 Rust、你的執行環境與程式碼代理 |
--agent 可搭配 claude、codex,或任何會從 stdin 讀取提示的指令使用。若未指定,請將 TASK.md 交給你使用的工具。
拿出證據,不靠感覺
那個移植版本看似正確,實際上卻比較位元組而非字元。500 次實際呼叫中,有 148 次抓出了這個問題。除了錄製的呼叫,fast-anything 也會產生額外測試案例,並讓原始版本計算結果供比對:邊界案例(NaN、±infinity、-0.0、0 和 ±1、非 ASCII 文字、空輸入,以及最多放大 16 倍的輸入)和縮小後的輸入(極小片段與隨機片段)。所有案例都相符前,不會啟用移植版本:數值相同(浮點數誤差在 1e-9 以內),原始版本會產生錯誤的地方也必須產生錯誤。若每次呼叫的速度比原始版本慢,也不會啟用移植版本(呼叫 Rust 的成本可能高於省下的運算時間)。任何時候執行 FAST_ANYTHING_DISABLE=1 都會使用原始版本。
結果
在 i5-10500、Windows 11 上的實際執行結果(C 和 C++ 使用 GitHub Actions 的 4 核心 Linux 執行器)。可從 examples/ 重現。
| 應用程式 | 改善前 | 改善後 |
|---|---|---|
| Python 模糊去重(700 個名稱) | 4.91s | 42ms,116 倍 |
| TypeScript 模糊去重(2,000 個名稱) | 3.11s | 155ms,20 倍 |
| PHP 模糊去重(600 個名稱) | 2.94s | 53ms,55 倍 |
| Go 模糊去重(3,000 個名稱) | 3.02s | 144ms,21 倍 |
| Ruby 模糊去重(400 個名稱) | 3.13s | 228ms,14 倍 |
| C# 模糊去重(4,000 個名稱) | 4.03s | 312ms,13 倍 |
| Java 模糊去重(4,000 個名稱) | 3.50s | 1.18s,3 倍(函式本身快 11 倍,其餘時間耗在 JVM 啟動) |
| C 語言 Mandelbrot(8 個縮放層級) | 431ms | 127ms,3.4 倍 |
| C++ 模糊去重(6,000 個名稱) | 3.02s | 1.09s,2.7 倍 |
fast-anything 會移植它所能觸及的最外層迴圈,而不是迴圈內呼叫的小函式,因此應用程式只需進入 Rust 一次,不必進入數百萬次。只移植內層的 levenshtein,效能提升幅度分別為 35 倍和 1.9 倍。
為什麼不全部重寫?
- 編譯時間:每個移植版本都是隻含一個函式的 crate。只要幾秒,不用好幾分鐘。
- 快取:所有移植版本共用一個
.fast/target。想刪除時隨時都可以。 - 風險:你的程式碼維持原樣。每個函式都可選擇移植到 Rust,並以實際行為進行檢查。
程式碼代理
- Claude Code 外掛:
/plugin marketplace add EL4CTEO/fast-anything,接著執行/plugin install fast-anything@fast-anything和/fast-anything:fast python app.py - MCP 伺服器(Claude Code、Codex、Cursor 等),內建於執行檔:
claude mcp add fast-anything -- fast-anything mcp。提供 8 個工具:fast_scan、fast_port、fast_verify、fast_enable、fast_disable、fast_bench、fast_report、fast_status。 - 技能:
skills/fast-anything會教任何程式碼代理如何執行這個流程。
程式語言
| 語言 | 繫結方式 | 狀態 |
|---|---|---|
| Python 3.10+ | PyO3 | ✅ |
JavaScript / TypeScript(Node 22+、Bun、Deno 2+:bun app.ts、deno run -A app.ts) |
napi-rs | ✅ |
| Ruby 3.3+ | 透過 Ruby 內建的 Fiddle 使用 C ABI + JSON | ✅ |
Java 22+(java App.java、Maven、Gradle) |
透過 FFM API 使用相同的 C 橋接介面 | ✅ |
Kotlin/JVM(Gradle、src/main/kotlin、JDK 22+) |
Java bridge;頂層函式、object 與伴生物件成員、擴充函式 |
✅ |
Go 1.22+(go run .) |
透過 Windows 載入器或 dlopen 使用相同的 C bridge(cgo) | ✅ |
PHP 8.1+(php app.php) |
透過 PHP 的 FFI 擴充功能使用相同的 C bridge(extension=ffi) |
✅ |
C 與 C++(gcc、clang 或 Intel oneAPI icx/icpx:clang -O2 main.c lib.c) |
透過 LoadLibrary 或 dlopen 使用相同的 C bridge | ✅ |
C# / .NET 8+(dotnet run -c Release) |
透過 NativeLibrary 使用相同的 C bridge;以 EventPipe 進行效能分析,無須安裝任何專案 | ✅ |
它會移植接收一般資料(數字、字串、清單、字典、型別化陣列……)的頂層確定性函式,也包含入口指令碼中的函式,只要主要程式碼位於 if __name__ == "__main__":(或 if __FILE__ == $0、if (import.meta.main) / if (require.main === module))之下即可。在 Python 中,這指的是模組層級函式與 @staticmethod(dataclass、NamedTuple 和數值型 NumPy 陣列都算一般資料);在 Java、C# 和 PHP 中,則是靜態方法(以及 PHP 函式);在 Go 中是一般函式;在 C 和 C++ 中則是自由函式與靜態方法。scan 說明瞭其他專案目前無法移植的原因。
在 Windows 上使用 Intel oneAPI 時,請從執行過 setvars.bat 的命令列執行 fast-anything(它會設定連結器)。SYCL 核心會在裝置上執行,不會移植;使用 -fsycl 時,只會分析效能並移植主機函式。
Ruby、Java、Go、PHP、C、C++ 和 C# 不需要標頭檔、繫結或額外工具:移植結果是隻有一個 C 進入點、可接收並回傳 JSON 的一般 Rust 函式庫,而 fast-anything 會直接以記錄下來的呼叫來執行它。任何能呼叫 C 的語言都能使用這個 bridge。
授權條款
MIT


