Hoi hoi! 👋
我是 @nyaomaru,一位熱愛 TypeScript 和蝦蛄、不是螃蟹的前端工程師!🦐
結果不知怎麼地,我最後竟然用 Rust 做出了一個工具。🙀🦀
最近,我發佈了一個新的開源 CLI 工具,叫做 type-tune。
https://github.com/necoz-oss/type-tune
type-tune 會找出共用的 TypeScript 型別,並協助把它們搬到更適合的位置,同時不需要手動更新 imports、依賴項和 barrel exports。
但為什麼一個由 TypeScript 愛好者打造的 TypeScript 工具,會是用 Rust 寫的呢?🤔
理所當然地,type-tune 的原始實作是用 TypeScript 寫的。
到了 9 月,它已經完成了,包含測試、註解和空白行在內,總共接近 20,000 行 TypeScript。
大約就在那個時候,我剛好看了 DHH 的這支影片。
https://www.youtube.com/watch?v=vDjW_dRyKXY
雖然我不是完全認同裡面的每個觀點,但我特別喜歡其中「善用這個時代,去追求真正讓我們興奮的事物」這個想法。
當然,除了個人專案之外,我不認為我們可以把一切都直接交給 AI。終究還是需要有人去理解並維護軟體。
但看著那支影片時,我腦中閃過一個簡單的念頭。
既然可以從 Rails 轉到 Rust,為什麼不能從 TypeScript 轉到 Rust 呢?🦀
我已經有一個可運作的實作、設計文件、測試,以及定義清楚的 TypeScript 型別。
例如,把這樣的資料模型:
type CandidateKind = "typeAlias" | "interface";
type Candidate = {
id: string;
name: string;
kind: CandidateKind;
referrers: string[];
};
翻成類似這樣的東西:
enum CandidateKind {
TypeAlias,
Interface,
}
struct Candidate {
id: String,
name: String,
kind: CandidateKind,
referrers: Vec<String>,
}
當然,把整個應用程式搬過去,遠不只是翻譯型別定義而已。
但因為已經有現成的設計和實作,過程變得容易很多。
在 AI 的幫助下,我把它完成了遷移,而且只是把它當作副業來做,整個過程不到一個月。
成果相當令人滿意 😻
你仍然可以像安裝其他熟悉的 TypeScript 開發工具一樣安裝 type-tune。
pnpm add -D type-tune
npm 啟動器需要 Node.js 22 以上,但核心實作會以原生二進位檔執行。
到目前為止,一切都很好!
除了那一個小問題。😿
我幾乎不懂 Rust。😹
我很習慣審查 AI 生成的 TypeScript 程式碼,但對 Rust 來說,我還在學基礎。
例如,考慮所有權和借用。
在 TypeScript 裡,這樣完全沒問題:
function printName(name: string) {
console.log(name);
}
const name = "OrderSummary";
printName(name);
console.log(name); // OK
但在 Rust 裡,類似的實作無法編譯。
fn print_name(name: String) {
println!("{}", name);
}
fn main() {
let name = String::from("OrderSummary");
print_name(name);
println!("{}", name); // Error: value borrowed after move
}
name 的所有權被轉移給了 print_name。
修正的方法之一,是改成借用這個值。
fn print_name(name: &str) {
println!("{}", name);
}
fn main() {
let name = String::from("OrderSummary");
print_name(&name);
println!("{}", name); // OK
}
另一種做法是複製這個值。
print_name(name.clone());
println!("{}", name); // OK
這兩種解法都能編譯,但不必要的複製可能會導致額外配置記憶體。
所以當 AI 產生 .clone() 時,我需要理解它到底是不是必要的,還是其實用借用比較適合。
同樣的情況也適用於可見性邊界。
例如,把內部 helper 設為公開,可能可以解決存取性問題:
pub fn resolve_destination() {
// ...
}
但如果這個函式只在同一個 crate 內使用,把它暴露給外部也許沒有必要。
pub(crate) fn resolve_destination() {
// ...
}
而如果它只在自己的模組內使用,那它甚至可以維持私有。
fn resolve_destination() {
// ...
}
編譯器接受這三種宣告,但每一種都代表不同的架構決策。
我也還在學習什麼時候應該使用 macro,什麼時候一般函式就夠了。
AI 可以產生可編譯的程式碼,但我仍然需要判斷它的設計選擇是否合適。
在 TypeScript 裡,我可以相對快速地做出這些決定。在 Rust 裡,我常常得先停下來學點東西,才能繼續審查。
AI 能生成 Rust 程式碼的速度,遠比我理解它的速度快。
我原本想加速副業專案的開發,卻引入了一個新的瓶頸。
我自己。
多棒的最佳化啊!😹
當然,我也可以直接 vibe code。
AI 每次問我是否要核准時,我都可以一直按 Enter,大概就能更快地發佈功能。
但對我來說,創造一些東西卻什麼都沒學到,只不過又是另一項工作而已。
而我相信,如果我一直只做這種事,最終我會逐漸失去創造的能力。
我喜歡用 AI 來學習不熟悉的概念,並探索新的做法。
但我不想把時間都花在只生產東西、卻不理解自己在做什麼。
我不想變成一個非常昂貴的 Enter 鍵。 😹
我後悔選擇 Rust 嗎?
完全不會!
這是一段很有價值的經驗,我也很感謝我們活在這樣一個時代,能如此輕鬆地挑戰自己。
接下來,讓我來談談我實際做了什麼!
有一個架構決策在整個遷移過程中始終沒有改變。
Scan / Plan / Apply
以一個典型的 TypeScript 專案為例。
src/
├── features/
│ ├── orders/
│ │ └── order-page.ts
│ ├── dashboard/
│ │ └── dashboard.ts
│ └── reports/
│ └── reports.ts
一開始,某個型別屬於 orders 這個功能模組。
// features/orders/order-page.ts
export type OrderSummary = {
id: string;
total: number;
};
但隨著應用程式成長,其他功能模組也開始匯入它。
// features/dashboard/dashboard.ts
import type { OrderSummary } from "../orders/order-page";
export function calculateRevenue(orders: OrderSummary[]) {
return orders.reduce((sum, order) => sum + order.total, 0);
}
// features/reports/reports.ts
import type { OrderSummary } from "../orders/order-page";
export function createReport(order: OrderSummary) {
return `${order.id}: ${order.total}`;
}
這個型別依然有用,但它原本所在的位置可能已經不再合適。
像 Knip 這類工具,能幫助我們移除未使用的程式碼。
type-tune 解決的是另一個問題:重新整理仍在使用中的型別。
pnpm exec type-tune scan --project tsconfig.json
type-tune 會分析已匯出的 type alias、interface、參照關係,以及相關依賴,找出可能的抽離候選項。
不會修改任何原始碼。
找出可以移動的型別,不代表它就應該被移動。
因此 type-tune 會產生一份可供審查的計畫。
pnpm exec type-tune plan \
--project tsconfig.json \
--out .type-tune/plan.json \
--markdown .type-tune/plan.md
它會產生兩個檔案:
plan.json — 候選項中繼資料與驗證資訊。plan.md — 方便人類閱讀與編輯的計畫。預設情況下,每個候選項都會被忽略。
以下是一個簡化版的 plan.md 範例:
- [ignore] <candidate-id> `OrderSummary`
- kind: `typeAlias`
- from: `src/features/orders/order-page.ts`
- to: `src/features/orders/types/order.ts`
你可以核准這個候選項,並自訂它的目的地。
- [ignore] <candidate-id> OrderSummary
+ [apply] <candidate-id> OrderSummary
- kind: typeAlias
- from: src/features/orders/order-page.ts
- - to: src/features/orders/types/order.ts
+ - to: src/domains/orders/types/order-summary.ts
它也許屬於共用目錄、某個特定領域模組,或甚至就維持原位。
這就是一個架構決策。
由你決定哪些要移動,以及要移到哪裡。
先預覽選定的變更:
pnpm exec type-tune apply \
--plan .type-tune/plan.json \
--markdown .type-tune/plan.md \
--dry-run
然後實際套用:
pnpm exec type-tune apply \
--plan .type-tune/plan.json \
--markdown .type-tune/plan.md
最後的專案結構如下:
src/
├── domains/
│ └── orders/
│ └── types/
│ └── order-summary.ts ← 已搬移!
└── features/
├── orders/
│ └── order-page.ts
├── dashboard/
│ └── dashboard.ts
└── reports/
│ └── reports.ts
型別現在住在新的地方。
// domains/orders/types/order-summary.ts
export type OrderSummary = {
id: string;
total: number;
};
支援的 imports 也會自動更新。
- import type { OrderSummary } from "../orders/order-page";
+ import type { OrderSummary } from "../../domains/orders/types/order-summary";
而原本的模組會保留相容性的 re-export。
// features/orders/order-page.ts
export type { OrderSummary } from "../../domains/orders/types/order-summary";
type-tune 也會使用 TypeScript 編譯器驗證這次重寫,如果一般驗證失敗,就會回復變更。
你仍然應該檢查最後的 diff,並執行你的專案專屬測試與建置。
為什麼要把 Scan、Plan 和 Apply 分開?
因為發掘機會、做出架構決策、以及執行變更,這三者是不同的責任。
type-tune 甚至支援可選的 AI 輔助審查:
pnpm exec type-tune plan \
--project tsconfig.json \
--ai-review \
--ai-dry-run
AI 可以提供額外的審查註記,但它不會控制原始碼重寫。上面的指令會在不連接任何供應商的情況下,預覽 AI 審查請求。
有趣的是,這也正是我希望自己在開發時與 AI 合作的方式。
自動化那些繁瑣的工作,但不要把架構決策從開發者手中拿走。
這就是 type-tune 背後的理念。
你可以先從掃描你的專案開始。
npx type-tune scan --project tsconfig.json
現在不用急著搬任何東西。先看看你能找到什麼吧!😸
https://github.com/necoz-oss/type-tune
https://type-tune-docs.vercel.app/
歡迎隨時提供回饋、想法、問題與貢獻!
如果你是 Rust 開發者,也請教教這隻可憐的 TypeScript 貓怎麼變成一隻合格的螃蟹。😹🦀
小巧。簡單。有用。一起打造!
感謝你的閱讀!🙌💚
原文出處:https://dev.to/necoz/why-i-rewrote-type-tune-from-typescript-to-rust-1egg