Skip to content

要安裝 Bun 內置 API 的 TypeScript 類型定義,安裝 @types/bun

sh
bun add -d @types/bun # 開發依賴

此時,你應該能夠在 TypeScript 文件中引用 Bun 全局變量,而不會在編輯器中看到錯誤。

ts
console.log(Bun.version);

建議的 compilerOptions

Bun 支持頂級 await、JSX 和 .ts 擴展導入等功能,TypeScript 默認不允許這些。下面是為 Bun 項目推薦的一組 compilerOptions,這樣你可以使用這些功能而不會看到 TypeScript 的編譯器警告。

jsonc
{
  "compilerOptions": {
    // 環境設置和最新特性
    "lib": ["ESNext"],
    "target": "ESNext",
    "module": "Preserve",
    "moduleDetection": "force",
    "jsx": "react-jsx",
    "allowJs": true,

    // Bundler 模式
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "verbatimModuleSyntax": true,
    "noEmit": true,

    // 最佳實踐
    "strict": true,
    "skipLibCheck": true,
    "noFallthroughCasesInSwitch": true,
    "noUncheckedIndexedAccess": true,
    "noImplicitOverride": true,

    // 一些更嚴格的標志(默認禁用)
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "noPropertyAccessFromIndexSignature": false,
  },
}

如果你在新目錄中運行 bun init,這個 tsconfig.json 將為你生成。(更嚴格的標志默認禁用。)

sh
bun init

Bun學習網由www.bunjs.com.cn整理維護