C# Custom Debugger - VS Code Extension

A powerful Visual Studio Code extension that enables building, running, and debugging C# code with personalized configurations. This extension integrates seamlessly with VS Code's existing functionality while allowing users to customize compilation flags, execution parameters, and debugging preferences.

Features

🔨 Build Management

• Custom Build Configurations: Configure MSBuild parameters, target frameworks, and compilation flags
• Project Cleaning: Clean build artifacts with customizable options
• Package Restoration: Restore NuGet packages with configurable sources
• Real-time Build Status: Visual feedback through status bar indicators

🚀 Run Management

• Flexible Execution: Run applications with custom arguments and environment variables
• Multiple Output Options: Choose between integrated terminal or output channel
• Working Directory Control: Set custom working directories for execution
• Process Management: Start, stop, and monitor running applications

🐛 Debug Integration

• Seamless VS Code Integration: Works with VS Code's built-in debugging capabilities
• Custom Debug Configurations: Create and manage personalized debug settings
• Attach to Process: Debug running applications by attaching to processes
• Advanced Breakpoint Support: Full support for conditional breakpoints and logging

⚙️ Configuration Management

• Project-Specific Settings: Configure settings per project or globally
• User-Friendly Interface: Easy-to-use configuration dialogs
• Settings Validation: Automatic validation of configuration parameters
• Import/Export: Share configurations across projects and teams

🎯 User Interface

• Command Palette Integration: Access all features through VS Code's command palette
• Status Bar Indicators: Real-time status updates for build, run, and debug operations
• Context Menus: Right-click integration for quick access to common operations
• Error Management: Comprehensive error handling with detailed logging

Installation

From VS Code Marketplace

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X)
3. Search for "C# Custom Debugger"
4. Click Install

From VSIX Package

1. Download the latest .vsix file from releases
2. Open VS Code
3. Run command Extensions: Install from VSIX...
4. Select the downloaded .vsix file

Requirements

• VS Code: Version 1.74.0 or higher
• .NET SDK: .NET 6.0 or higher
• Operating System: Windows, macOS, or Linux

Quick Start

1. Open a C# Project: Open a folder containing C# projects (.csproj, .sln)
2. Configure Settings: Use C# Custom: Configure Build Settings command
3. Build Project: Use C# Custom: Build command or Ctrl+Shift+B
4. Run Application: Use C# Custom: Run command
5. Debug Application: Use C# Custom: Debug command or F5

Commands

Configuration

Build Settings

{
  "csharpCustom.build.configuration": "Debug",
  "csharpCustom.build.platform": "Any CPU",
  "csharpCustom.build.verbosity": "minimal",
  "csharpCustom.build.additionalArgs": [],
  "csharpCustom.build.restoreBeforeBuild": true
}

Run Settings

{
  "csharpCustom.run.arguments": [],
  "csharpCustom.run.workingDirectory": "",
  "csharpCustom.run.environmentVariables": {},
  "csharpCustom.run.useExternalTerminal": false
}

Debug Settings

{
  "csharpCustom.debug.justMyCode": true,
  "csharpCustom.debug.enableStepFiltering": true,
  "csharpCustom.debug.suppressJITOptimizations": false,
  "csharpCustom.debug.symbolOptions": {
    "searchPaths": [],
    "searchMicrosoftSymbolServer": true
  }
}

Troubleshooting

Common Issues

Build Fails with "dotnet not found"

• Ensure .NET SDK is installed and in PATH
• Run C# Custom: Validate Environment to check installation

Debug Session Won't Start

• Verify project builds successfully
• Check debug configuration in launch.json
• Ensure C# extension is installed

Extension Not Activating

• Check if workspace contains C# files
• Verify VS Code version compatibility
• Check extension logs in Output panel

Getting Help

1. Check Error History: Use C# Custom: Show Error History for detailed error information
2. Validate Environment: Run C# Custom: Validate Environment to check setup
3. View Logs: Check the "C# Custom Debugger" output channel
4. Report Issues: Create an issue on GitHub with error details

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Development Setup

1. Clone the repository
2. Run npm install
3. Open in VS Code
4. Press F5 to launch extension development host

Building

npm run compile
npm run package

Testing

npm test

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

See CHANGELOG.md for a detailed history of changes.

Support

• Documentation: Wiki
• Issues: GitHub Issues
• Discussions: GitHub Discussions

Enjoy coding with C# Custom Debugger! 🚀