Skip to main content

TypeScript 6 and 7

还没翻译译自英文(bun.com)本页 14 段都还没译

TypeScript 6.0 changed how it discovers type definitions. If you've upgraded TypeScript and your editor no longer recognizes Bun, Request, or other globals from @types/bun, here's how to fix it.

What changed

Starting in TypeScript 6.0, the types field in compilerOptions defaults to an empty array instead of including all @types/* packages. You now need to explicitly list the type packages you use.

Add "types": ["bun"] to your tsconfig

In your tsconfig.json, add "types": ["bun"] to compilerOptions:

{
  "compilerOptions": {
    "types": ["bun"],
  },
}

The types array tells TypeScript to load type definitions from @types/bun. If you use other @types/* packages, include them too:

{
  "compilerOptions": {
    "types": ["bun", "react"],
  },
}

You still need @types/bun installed. The types option tells TypeScript which packages to include, but the package itself must exist in node_modules:

bun add -d @types/bun

Here's the full recommended tsconfig.json for a Bun project using TypeScript 6.0 or later:

{
  "compilerOptions": {
    // Environment setup & latest features
    "lib": ["ESNext"],
    "target": "ESNext",
    "module": "Preserve",
    "moduleDetection": "force",
    "jsx": "react-jsx",
    "allowJs": true,
    "types": ["bun"],

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

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

    // Some stricter flags (disabled by default)
    "noUnusedLocals": false,
    "noUnusedParameters": false,
    "noPropertyAccessFromIndexSignature": false,
  },
}

Does this apply to TypeScript 7?

Yes. TypeScript 7 carries forward the same default. If you're upgrading directly from TypeScript 5 to 7, the same fix applies — add "types": ["bun"] to your compilerOptions.

Does this apply to bun check?

Yes. bun check behaves like TypeScript 7, whichever version of typescript you have installed. See Coming from TypeScript 5 for the other defaults and options that changed.

译文 © 2026 fanyi.dev · 原文 © 2026 the Bun project (LICENSE.md names no copyright holder) (MIT)