DebugTrace for Dart

Say goodbye to manual print statements and hello to efficient debugging

DebugTrace is a VS Code extension that supercharges your Dart debugging by automatically generating contextual debug statements.

Basic Usage

Place cursor on any variable in your Dart file
Ctrl+L / Cmd+L for instant log insertion

🎮 Commands & Shortcuts

Command	Shortcut	Description
`DebugTrace: Insert Log`	`Ctrl+L` / `Cmd+L`	Generate debug log for variable at cursor
`DebugTrace: Insert Log with Message`	`Ctrl+Shift+L` / `Cmd+Shift+L`	Generate debug log with custom message
`DebugTrace: Delete All Logs`	`Ctrl+Alt+L` / `Cmd+Alt+L`	Remove all DebugTrace logs from file
`DebugTrace: Comment All Logs`	`Ctrl+Alt+C` / `Cmd+Alt+C`	Comment out all DebugTrace logs
`DebugTrace: Uncomment All Logs`	`Ctrl+Alt+U` / `Cmd+Alt+U`	Uncomment all DebugTrace logs

🎯 Quick Start

Example

String userName = "Alice";
int userAge = 25;

After using DebugTrace with print():

String userName = "Alice";
print('DebugTrace🔎: [main.dart:1] userName: ${userName}');
int userAge = 25;
print('DebugTrace🔎: [main.dart:3] userAge: ${userAge}');

After using DebugTrace with debugPrint():

String userName = "Alice";
debugPrint('DebugTrace🔎: [main.dart:1] userName: ${userName}');
int userAge = 25;
debugPrint('DebugTrace🔎: [main.dart:3] userAge: ${userAge}');

⚙️ Configuration

Customize DebugTrace through VS Code settings:

{
  "debugtrace.logType": "print",           // "print" | "debugPrint"
  "debugtrace.logMessagePrefix": "DebugTrace🔎:",     // Custom prefix
  "debugtrace.includeFileInfo": true,      // Include [file:line]
  "debugtrace.addSeparatorLine": false     // Add separator after logs
}

🎨 Why DebugTrace?

The Problem

Manual debugging is slow: Writing print() statements by hand
Inconsistent format: Different developers use different debug styles
Context missing: Hard to track which file/line generated the output
Cleanup overhead: Manually removing debug statements before commit

The Solution

⚡ Fast insertion: One command generates perfect debug statements
📍 Rich context: Always know the source of your debug output
🎛️ Consistent format: Team-wide standardized debug messages
🧹 Easy cleanup: Remove all debug logs with one command

📋 Requirements

VS Code: Version 1.74.0 or higher
Dart files: Extension only activates in .dart files
Dart SDK: Any version (extension doesn't require specific Dart version)

🤝 Contributing

Found a bug or have a feature request?

📄 License

MIT License - see LICENSE file for details.

Happy Debugging! 🐛➡️✨

Debug Trace

Prashant Gupta