Bun

TypeScript

要安装 Bun 内置 API 的 TypeScript 定义,请安装 @types/bun

bun add -d @types/bun # dev dependency

此时,您应该能够在 TypeScript 文件中引用 Bun 全局变量,而不会在编辑器中看到错误。

console.log(Bun.version);

建议的 compilerOptions

Bun 支持顶层 await、JSX 和带扩展名的 .ts 导入等功能,而 TypeScript 默认情况下不允许这些功能。以下是 Bun 项目推荐的 compilerOptions 设置,以便您可以使用这些功能,而不会在 TypeScript 中看到编译器警告。

{
  "compilerOptions": {
    // Enable latest features
    "lib": ["ESNext"],
    "target": "ESNext",
    "module": "ESNext",
    "moduleDetection": "force",
    "jsx": "react-jsx",
    "allowJs": true,

    // Bundler mode
    "moduleResolution": "bundler",
    "allowImportingTsExtensions": true,
    "verbatimModuleSyntax": true,
    "noEmit": true,

    // Best practices
    "strict": true,
    "skipLibCheck": true,
    "noFallthroughCasesInSwitch": true,

    // Some stricter flags
    "noUnusedLocals": true,
    "noUnusedParameters": true,
    "noPropertyAccessFromIndexSignature": true
  }
}

如果您在新目录中运行 bun init,将为您生成此 tsconfig.json。(默认情况下,更严格的标志处于禁用状态。)

bun init