Guides

Task-shaped recipes. Each one answers a question of the form how do I debug X, with a working config and the command to run it.

Every recipe has the same shape: the task in one line, prerequisites, the config, the command, what should happen, and what to do when it does not.

By language

Recipe	Language
Debug a Rust executable	Rust
Debug cargo test	Rust
Debug Go tests	Go
Debug pytest	Python
Debug PHP CLI	PHP
Debug PHP-FPM	PHP
Debug PHP in Docker	PHP

Across languages

Recipe	What it covers
Debug the test under the cursor	:DebugTest and --test-at
Attach to a running process	mode = "attach"
Pass arguments and environment	args, env, env_file

If your case is not here

The recipes are combinations of a small number of settings. When none matches, build your own from:

• Configuration → Profiles — the fields and what they do;
• Debug adapters — what your adapter expects;
• Configuration → Reference — every key, with defaults.

And when something behaves unexpectedly rather than being unconfigured, start from Troubleshooting.