Awesome
VS Code Bash Debug
A bash debugger GUI frontend based on awesome bashdb
scripts (bashdb now included in package).
Overview
This is a SIMPLE bashdb debugger frontend. Useful for learning bash shell usage and writing simple scripts.
Useful hint: shellcheck extension does a great job with finding common script errors before debugging.
Usage
- Select Debug -> Add Configuration to add custom debug configuration (drop-down, path-input, etc...)
- Select Debug -> Start Debugging (F5) to start debugging
See https://code.visualstudio.com/docs/editor/debugging for general usage.
Sample features
- Debugging auto-configuration via
launch.json
- Simple debugging in hello world application
- Standard input handling via terminal
- Pause support while script is running
- Advanced "Watch" and "Debug console" usage
- Conditional breakpoints usage
For Windows users:
- Install Windows Subsystem for Linux
- Terminal has problems with spaces in paths when powershell is used, use WSL bash instead. For beta WSL please read this
pathBash
refers to BASH binary path in WSL filesystem, not path towsl.exe
/bash.exe
For macOS users:
- Read here if your mac has
/usr/local/bin/pkill
. - Install
bash
version4.*
and setpathBash
properly
Dependencies
bash
version4.0
or latercat
,mkfifo
,rm
,pkill
Limitations and known problems
- Use
terminalKind
@launch.json
set tointegrated
orexternal
for interactive scripts (using stdin) - Currently debugger stops at first command
$0
variable shows path to bashdb- Older
bash
versions (4.0
-4.2
) are not tested, but might work™ BASH_REMATCH
gets overwritten when stepping through code