如何安裝並使用 bun：安裝、執行腳本、加入套件並啟動專案

依官方步驟安裝 bun，跑通一個腳本，加入一個套件，並用 bun init 啟動第一個專案。

要在本機用 bun 跑 JavaScript 或 TypeScript，先完成四件事：依官方方式安裝，bun 直接跑一個腳本，bun add 加一個套件，再用 bun init 建立第一個專案。

依 bun.sh/docs/installation 走，不要猜安裝套件名。核心檢索詞是 如何安裝 bun、bun add，以及 bun init。安裝入口在 bun.sh。

先依系統裝官方二進位

安裝、跑腳本、加套件、建專案

1. 01
   安裝並確認版本

   依 bun.sh/docs/installation 選腳本或 Homebrew。裝完 bun --version 應印出版本。找不到指令就重開終端機，檢查 PATH。升級用 bun upgrade。

2. 02
   執行一個腳本

   寫 hello.ts（或 hello.js），執行 bun hello.ts。bun 自帶執行環境，TypeScript 不必先走 tsc。有 package.json 腳本時用 bun run <script>。

3. 03
   加入一個套件

   在專案目錄執行 bun add zod（示例）。bun 會解析依賴、寫 lockfile。失敗時核對套件名與網路，不要手改半截 lockfile。

4. 04
   啟動第一個專案

   空目錄裡執行 bun init，依提示產生 package.json 與入口檔。然後 bun run 預設腳本，或直接 bun index.ts。已有倉庫用 bun install 裝依賴。

curl -fsSL https://bun.sh/install | bash
bun --version
printf 'console.log("ok")\n' > hello.ts
bun hello.ts
mkdir myproject && cd myproject
bun init
bun add zod
# 寫好入口後：
bun index.ts

必須用官方安裝腳本嗎？

不必。文件還列出 Homebrew、npm、Scoop 等管道。選一種，裝完用 bun --version 驗證即可。不要混裝多個互搶 PATH 的副本。

還要先裝 Node 才能跑 TypeScript 嗎？

日常不必。bun 自帶執行環境，可直接執行 .ts。若專案腳本寫死 node，仍可能需要對照官方相容說明。

bun add 和 npm install 有何不同？

目標都是往專案加依賴。bun add 用 bun 的解析器與 lockfile（bun.lock）。不要在同一目錄輪流用 npm / pnpm / bun 各寫一份鎖，以免對不齊。

裝完就能當白板用嗎？

不能。這是本機 JavaScript 工具鏈。要對著同一張圖說話時，再開 sitdraw。