# vsc-dap

**Repository Path**: grateful/vsc-dap

## Basic Information

- **Project Name**: vsc-dap
- **Description**: vscode dap 项目
- **Primary Language**: TypeScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-07
- **Last Updated**: 2025-01-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## VSCode DAP开源调试器项目需求
### 一、项目背景
随着多线程编程的普及，开发者在调试多线程应用时面临更大的挑战。VSCode作为一款流行的代码编辑器，通过其扩展机制和DAP协议，为开发者提供了强大的调试支持。本项目旨在开发一个基于DAP的开源调试器，以支持特定编程语言或框架的多线程调试需求。

### 二、项目目标
实现DAP协议，确保调试器能够与VSCode等支持DAP的IDE无缝集成。
支持特定语言/框架的多线程调试，提供全面的调试信息。
允许开发者在调试过程中轻松查看和切换线程。
提供跨平台支持，确保调试器能够在不同操作系统上运行。
优化用户体验，提供直观易用的调试界面和文档。
### 三、功能需求
1. 多线程查看
线程列表：调试器应提供一个线程列表视图，显示当前程序中所有活动线程的状态（如运行、暂停、终止等）。
线程详细信息：允许开发者查看每个线程的详细信息，包括线程ID、堆栈信息、局部变量等。
高亮当前线程：在调试过程中，高亮显示当前正在调试的线程，以便开发者快速识别。
2. 多线程切换
手动切换线程：调试器应允许开发者在调试过程中手动切换到其他线程进行调试。这可以通过线程列表视图或快捷键实现。
断点与线程关联：支持设置与特定线程关联的断点，当该线程执行到断点时触发调试。
保持线程同步：在切换线程时，调试器应确保其他线程的状态不会受到影响，并保持同步更新。
3. 其他调试功能
断点管理：支持设置、删除和启用/禁用断点，显示断点位置及其状态。
变量查看：在调试过程中实时查看和修改变量的值，支持嵌套变量和复杂数据结构的展示。
调用堆栈：显示当前的调用堆栈，允许开发者回溯代码执行路径，并支持选择堆栈帧以查看该帧的局部变量和上下文。
表达式求值：允许开发者在调试过程中输入表达式并求值，支持复杂的表达式和函数调用。
日志和输出：提供调试过程中的日志和输出信息，帮助开发者诊断问题，支持将日志保存到文件或复制到剪贴板。
### 四、非功能需求
性能：确保调试器在处理大型代码库和复杂调试场景时保持高效。
稳定性：避免调试过程中出现崩溃或挂起现象。
安全性：保护用户数据免受恶意代码或未经授权的访问。
易用性：提供简洁明了的用户界面和文档，降低学习曲线。
可维护性：采用模块化设计，确保代码易于理解和维护。
### 五、开发计划
需求分析：明确项目目标和功能需求，制定开发计划。
架构设计：设计调试器的整体架构，包括多线程查看和切换模块、通信协议、数据处理和用户界面等部分。
编码实现：按照架构设计逐步实现各个功能模块，特别是多线程查看和切换功能。
测试与验证：对调试器进行单元测试、集成测试和性能测试，确保功能正确性和稳定性。特别是针对多线程调试场景进行充分测试。
文档与发布：编写用户手册和开发文档，准备项目发布。特别要包含多线程调试的使用说明和最佳实践。