建立 2026-09-15 更新 2026-09-15

安裝與編譯

TypeScript 程式碼不能直接跑，要先編譯（compile／transpile）成 JavaScript。這一頁講怎麼裝好編譯器、怎麼把 .ts 變成 .js，以及開發時比較順手的做法。

安裝

需要先裝 Node.js（附帶 npm）。在專案資料夾裡：

npm install --save-dev typescript

裝完可以用 npx tsc --version 確認版本；npx 會執行本機專案裝的那一份 tsc，不用另外全域安裝。

npx tsc --init

會建立一個 tsconfig.json，裡面列出所有編譯選項（大多先被註解掉）。這個檔案讓你不用每次都在指令列打一堆參數，也讓編輯器（VS Code）知道要用哪些規則做即時檢查。常用選項見 tsconfig 常用設定。

hello.ts

function greet(name: string): string {
  return `Hello, ${name}!`
}

console.log(greet("TypeScript"))

npx tsc hello.ts
node hello.js

tsc 讀 hello.ts，在同資料夾產生 hello.js；node hello.js 才是真正在執行的那一步。專案裡有 tsconfig.json 時，直接打 npx tsc 就會依設定編譯整個專案，不用逐檔案指定。

方法一：邊改邊自動編譯

npx tsc --watch

tsc 會盯著檔案變化，自動重新編譯，另外開一個終端機跑 node 執行結果。

方法二：直接執行 .ts，不手動編譯

npm install --save-dev tsx
npx tsx hello.ts

tsx 會在背景即時轉譯再執行，很適合寫 Node.js 腳本、後端 API 時用；瀏覽器端專案（React、Vue）則交給 Vite／webpack 這類建置工具處理，不需要自己手動跑 tsc。

編輯器就是即時檢查器

VS Code 內建 TypeScript 語言服務，存檔前就會在程式碼下面畫紅線提示型別錯誤，不用真的執行 tsc 才知道哪裡錯。這也是多數團隊實際開發時的主要回饋管道。