How to configure Bun debug in VSCode

If you are using Bun as your Typescript runtime, you probably already wondered how you can configure VScode to debug your code with Bun.

I had to do a little digging but I finally found the solution.

Open launch.json file

You can open the .vscode/launch.json file by clicking in the File Explorer or you can create a new one by calling Debug: Add configuration.. from VScode command palette.

Hint: The same works in Cursor or Windsurf editors.

Add new configuration

1
{
2
  // ...
3
  "configurations": [
4
    {
5
      "type": "bun",
6
      "internalConsoleOptions": "neverOpen",
7
      "request": "launch",
8
      "name": "[Bun] Debug File",
9
      "program": "${file}",
10
      "cwd": "${workspaceFolder}",
11
      "noDebug": false,
12
      "watchMode": false
13
    },
14
    {
15
      "type": "bun",
16
      "internalConsoleOptions": "neverOpen",
17
      "request": "launch",
18
      "name": "[Bun] Run File",
19
      "program": "${file}",
20
      "cwd": "${workspaceFolder}",
21
      "noDebug": true,
22
      "watchMode": false
23
    },
24
    {
25
      "type": "bun",
26
      "internalConsoleOptions": "neverOpen",
27
      "request": "attach",
28
      "name": "[Bun] Attach Bun",
29
      "url": "ws://localhost:6499/",
30
      "stopOnEntry": false
31
    }
32
  ]
33
}

That's it!

Now you can head to your VSCode debug view and select [Bun] Debug File which will run currently opened file in debug mode.

Tip: If you are wondering how I'm using Bun - it's either for random project scripts written in Typescript, but I also use Bun to run tests in a few projects - I highly encourage you to give Bun a try.

DM me on Twitter/X what you think about Bun x.com/pavelsvitek.

Links

1. https://bun.sh
2. https://bun.sh/docs/cli/test