在雲原生與高性能服務的發展趨勢下，Go 項目遷移到 Rust 項目成為提升性能和穩定性的最重要優化方向，但依賴複雜、有語言門檻等問題長期制約着 Go2Rust 的大規模落地。字節跳動服務框架團隊基於內部大量遷移實踐，融合大模型能力與工程經驗，推出「半空」富腳手架模式，將遷移從“人工主導”轉變為“標準化流程”，為需要進行 Go2Rust 遷移的團隊提供了一套可落地的技術參考。
本文基於字節跳動服務框架團隊研發工程師範廣宇在 CloudWeGo 四週年技術沙龍上的演講內容整理，詳細拆解了「半空」富腳手架模式的設計邏輯、實施步驟與實踐成效。
點擊鏈接可查看本次分享回放👉🏻https://b23.tv/v7rRu7D
一、從 Go 到 Rust：不止於性能的追求
字節跳動內部的多個項目實踐已經證明，將 Go 服務遷移至 Rust，不僅能帶來顯著的 CPU 性能提升，還能有效增強服務穩定性、降低運維成本。這背後，是 Rust 語言本身在內存安全和高併發處理上的獨特優勢。
為了讓更多業務團隊享受到遷移帶來的紅利，服務框架團隊探索出兩條路徑：
- 間接優化：讓 Go 服務無需改造代碼，即可間接獲得 Rust 的性能優勢。（關於ROG 技術剖析和業務落地，可以點擊觀看視頻：https://b23.tv/35jPPMg）
- 完全遷移：通過自動化方案，將業務代碼完全遷移至 Rust，實現更徹底的性能飛躍。
「半空」富腳手架模式，正是為實現第二條路徑——規模化、低門檻的完全遷移——而生。
二、遷移面臨的三大挑戰
儘管 Go2Rust 的價值顯而易見，但長久以來，大規模落地始終面臨着三大挑戰：
- 陡峭的學習曲線：Rust 獨特的所有權、生命週期等概念，對習慣了 Go 的工程師來説，無疑是一道不低的門檻。這使得許多團隊在遷移面前望而卻步。
- 複雜的依賴黑洞：一個 Go 項目，其直接和間接依賴往往構成一個龐大的依賴樹。依賴的層級越深，遷移的複雜度就越高，甚至呈指數級增長。如何有效管理和遷移這些依賴，是一個棘手的問題。
- 不可控的翻譯質量：單純依賴大模型進行代碼翻譯，結果往往充滿不確定性。生成的“Go 味” Rust 代碼，不僅風格怪異，更難以滿足生產環境對代碼質量的嚴苛要求。
為了跨越這些鴻溝，服務框架團隊的遷移模式也經歷了持續的演進：從完全依賴人工經驗的“作坊式”遷移，到利用工具輔助的“漸進式”翻譯，再到如今將遷移升級為“標準化流程”的「半空」富腳手架模式。
三、「半空」富腳手架：三步走的標準化遷移流程
「半空」富腳手架的核心，是將複雜、高度依賴人工經驗的遷移過程，抽象、封裝成一個標準化的三步流程。它以 IDE 插件的形式提供服務，接收用户的 Go 項目，輸出一個 100% 可編譯、保留完整業務邏輯的 Rust 腳手架，徹底將工程師從繁瑣的“體力活”中解放出來。
這套流程完全復刻了資深工程師進行手動遷移時的心智模型，分為翻譯前、翻譯中、翻譯後三個階段。
第一步：翻譯前 —— 運籌帷幄，繪製精準遷移藍圖
如同建造大樓前需要有精確的施工圖紙，「半空」在啓動翻譯前，會進行一次徹底的“項目體檢”，為後續的自動化遷移繪製清晰的路徑。
- 項目深度理解文檔：自動解析項目並生成完整的項目梳理文檔，涵蓋整體架構、接口定義、函數邏輯、結構體設計等，讓工程師對項目全貌有宏觀的把握。
- 依賴梳理：系統性地梳理項目的直接與間接依賴，並智能標註出無需翻譯的依賴項。這不僅能精確評估遷移的工作量與難度，也讓遷移的範圍和質量變得清晰可控。
- 接口梳理及規劃：對於複雜的微服務項目，工具會自動提取目標接口及其完整的函數調用鏈，將龐大的業務邏輯拆解為一個個可以獨立編譯、驗證和運行的單元。
第二步：翻譯中 —— 黑盒操作，從“神似”到“形似”的精準轉化
準備工作就緒後，工程師只需在熟悉的 IDE 中一鍵觸發，即可啓動翻譯。
- 基礎映射與 IDE蒐集：針對 Kitex 微服務項目，自動完成從 Golang 框架到 Rust 框架的基礎結構映射，並自動化蒐集下游服務所依賴的 IDL 文件，免去了大量繁雜的手動梳理。
- “意譯”而非“直譯”：這是「半空」翻譯質量的核心保障。它以“節點”為基本單元，採用“意譯”的邏輯，深入理解 Golang 代碼的業務意圖，然後用最符合 Rust 語言習慣和最佳實踐的方式來生成代碼，從根本上避免了生硬、彆扭的“Go 風格 Rust 代碼”。
-
智能化的依賴處理：針對不同類型的依賴，「半空」採取了不同的處理策略：
- 本地依賴：通過遞歸翻譯直接遷移。
- 業務 SDK：標記為遞歸翻譯後，生成對應的 Rust 版本。
- 內部基礎組件：建立專門的知識庫，映射 Golang 組件在 Rust 中的等效實現與用法。
- 開源組件：優先調用知識庫中的成熟方案，當知識庫缺失時，再由大模型進行補全。
通過自下而上的遞歸翻譯邏輯，從最底層的函數開始，逐個節點完成編譯和翻譯，最終確保整個接口鏈路的完整性與可運行性。
第三步：翻譯後 —— 自動優化與輔助校驗，守好交付質量最後一關
翻譯完成不等於大功告成。為了確保交付的代碼能直接進入生產環境，「半空」還提供了一套完善的“售後服務”。
- 基於 LLM Agent 驅動的代碼質量優化：一個內置的 Agent 會自動嘗試編譯生成的 Rust 代碼，智能解析編譯過程中出現的錯誤，並進行多輪自我修復。實踐證明，這能將代碼的初始編譯通過率從約 80%~90% 提升至 100% 可直接運行的狀態。
- IDE 輔助校驗：提供便捷的 IDE 校驗插件，支持翻譯後的 Rust 代碼與原始 Golang 源碼的一鍵跳轉、對比查看。這使得工程師可以像 Code Review 一樣，快速核對業務邏輯的一致性，確保遷移的準確無誤。
內部實踐表明，經「半空」處理後的代碼，質量已非常接近資深工程師手動編寫的水平，真正實現了高質量、低成本的規模化遷移。
四、未來展望：不止於遷移，更重塑研發體驗
「半空」富腳手架模式的推出，僅僅是 Go2Rust 工程化探索的第一步。服務框架團隊的目標，不止於實現 1:1 的精準翻譯，更希望藉此重塑 Rust 的研發體驗。截至發稿前，「半空」在字節內部已實現萬行代碼 0 編譯錯誤的翻譯交付。
- 引入 Deep Research 架構：在未來，服務框架團隊希望「半空」不僅能“翻譯”代碼，更能“重構”代碼。它將能自動將翻譯後的代碼，重構為更符合 Rust 最佳實踐的形態，充分釋放 Rust 語言的強大潛力。
- 持續推廣優化：服務框架團隊將持續擴大「半空」的推廣範圍，積累更多場景的遷移案例，並建立用户反饋的閉環。通過分析用户對翻譯代碼的修改，持續、智能地優化翻譯流程與代碼質量。
