# Debugging Bun with the VS Code extension (/docs/guides/runtime/vscode-debugger)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 533 · updated: 2026-07-28 -->
Related: [Install TypeScript declarations for Bun](/docs/guides/runtime/typescript.md), [Re-map import paths](/docs/guides/runtime/tsconfig-paths.md), [Debugging Bun with the web debugger](/docs/guides/runtime/web-debugger.md), [Inspect memory usage using V8 heap snapshots](/docs/guides/runtime/heap-snapshot.md), [Build-time constants with --define](/docs/guides/runtime/build-time-constants.md), [Define and replace static globals & constants](/docs/guides/runtime/define-constant.md)

<Note>
  The VS Code extension is buggy. We recommend the 

  [web debugger](/guides/runtime/web-debugger)

   instead.
</Note>

Bun speaks the [WebKit Inspector Protocol](https://github.com/oven-sh/bun/blob/main/packages/bun-inspector-protocol/src/protocol/jsc/index.d.ts), so you can debug your code with an interactive debugger.

***

To install the extension, visit the [Bun for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=oven.bun-vscode) page on the VS Code marketplace website, then click Install.

<Frame>
  ![VS Code extension](https://github.com/oven-sh/bun/assets/3084745/7c8c80e6-d49e-457a-a45e-45ebed946d56)
</Frame>

***

Alternatively, search `bun-vscode` in the Extensions tab of VS Code.

<Frame>
  ![VS Code extension](https://github.com/oven-sh/bun/assets/3084745/664b4c40-944c-4076-a4c2-f812aebd3dc9)
</Frame>

***

Make sure you are installing the extension published by the verified Oven organization.

<Frame>
  ![VS Code extension](https://github.com/oven-sh/bun/assets/3084745/73e6b09f-9ff1-4d85-b725-c5eb7215b6ae)
</Frame>

***

Once installed, two Bun-specific commands appear in the Command Palette. To open the palette, click View > Command Palette, or type `Ctrl+Shift+P` (Windows, Linux) or `Cmd+Shift+P` (Mac).

***

The `Bun: Run File` command executes your code and prints the output to the Debug Console in VS Code. Breakpoints are ignored; this is similar to executing the file with `bun <file>` from the command line.

<Frame>
  ![VS Code extension](https://github.com/oven-sh/bun/assets/3084745/1b2c7fd9-fbb9-486a-84d0-eb7ec135ded3)
</Frame>

***

The `Bun: Debug File` command executes your code and prints the output to the Debug Console in VS Code. You can set breakpoints in your code by clicking to the left of a line number; a red dot appears.

When you run the file with `Bun: Debug File`, execution pauses at the breakpoint. You can inspect the variables in scope and step through the code line-by-line using the VS Code controls.

<Frame>
  ![VS Code extension](https://github.com/oven-sh/bun/assets/3084745/c579a36c-eb21-4a58-bc9c-74612aad82af)
</Frame>