Hoi hoi! 👋

我是 @nyaomaru,一位熱愛 TypeScript 和蝦蛄、不是螃蟹的前端工程師!🦐

結果不知怎麼地,我最後竟然用 Rust 做出了一個工具。🙀🦀

最近,我發佈了一個新的開源 CLI 工具,叫做 type-tune。

https://github.com/necoz-oss/type-tune

type-tune 會找出共用的 TypeScript 型別,並協助把它們搬到更適合的位置,同時不需要手動更新 imports、依賴項和 barrel exports。

但為什麼一個由 TypeScript 愛好者打造的 TypeScript 工具,會是用 Rust 寫的呢?🤔


🐈 一切都從 TypeScript 開始

理所當然地,type-tune 的原始實作是用 TypeScript 寫的。

到了 9 月,它已經完成了,包含測試、註解和空白行在內,總共接近 20,000 行 TypeScript。

大約就在那個時候,我剛好看了 DHH 的這支影片。

https://www.youtube.com/watch?v=vDjW_dRyKXY

雖然我不是完全認同裡面的每個觀點,但我特別喜歡其中「善用這個時代,去追求真正讓我們興奮的事物」這個想法。

當然,除了個人專案之外,我不認為我們可以把一切都直接交給 AI。終究還是需要有人去理解並維護軟體。

但看著那支影片時,我腦中閃過一個簡單的念頭。

既然可以從 Rails 轉到 Rust,為什麼不能從 TypeScript 轉到 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 的幫助下,我把它完成了遷移,而且只是把它當作副業來做,整個過程不到一個月。

成果相當令人滿意 😻

  • 執行效能更好。
  • 可以產生原生二進位檔。
  • npm 使用者不需要 Rust 開發環境。

你仍然可以像安裝其他熟悉的 TypeScript 開發工具一樣安裝 type-tune。

pnpm add -D type-tune

npm 啟動器需要 Node.js 22 以上,但核心實作會以原生二進位檔執行。

到目前為止,一切都很好!

除了那一個小問題。😿


🙀 type-tune 變快了,開發者卻變慢了

我幾乎不懂 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 嗎?

完全不會!

這是一段很有價值的經驗,我也很感謝我們活在這樣一個時代,能如此輕鬆地挑戰自己。

接下來,讓我來談談我實際做了什麼!


🛠️ type-tune 背後的設計

有一個架構決策在整個遷移過程中始終沒有改變。

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 解決的是另一個問題:重新整理仍在使用中的型別。


🔍 1. Scan

pnpm exec type-tune scan --project tsconfig.json

type-tune 會分析已匯出的 type alias、interface、參照關係,以及相關依賴,找出可能的抽離候選項。

不會修改任何原始碼。


📋 2. Plan

找出可以移動的型別,不代表它就應該被移動。

因此 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

它也許屬於共用目錄、某個特定領域模組,或甚至就維持原位。

這就是一個架構決策。

由你決定哪些要移動,以及要移到哪裡。


🚚 3. Apply

先預覽選定的變更:

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 背後的理念。


💚 讓你的 TypeScript 型別有個更好的家!

你可以先從掃描你的專案開始。

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


精選技術文章翻譯,幫助開發者持續吸收新知。

共有 0 則留言


精選技術文章翻譯,幫助開發者持續吸收新知。
🏆 本月排行榜
🥇
boluoji
📝49   💬3   ❤️8
1,226
🥈
我愛JS
📝3   💬1   ❤️5
144
🥉
站長阿川
📝1   💬3   ❤️2
47
評分標準:發文×10 + 留言×3 + 獲讚×5 + 點讚×1 + 瀏覽數÷10
本數據每小時更新一次
📢 贊助商廣告 · 我要刊登