Microsoft VSCode JavaScript Debugger 指南

1. 目录结构及介绍

Microsoft的vscode-js-debug项目是专为调试JavaScript应用程序设计的DAP（Debug Adapter Protocol）兼容调试器。 其目录结构精心组织以支持其多功能性，并确保开发者可以高效地进行调试工作。以下是关键的目录和文件介绍：

• src: 核心源代码所在位置，包含了所有用于构建调试器的主要TypeScript文件。
• test: 单元测试和集成测试的代码存放区，确保功能的稳定性和正确性。
• vscode: 包含VS Code扩展相关的特定代码和配置。
• .gitattributes, .gitignore: 版本控制相关文件，定义了哪些文件应被Git忽略或如何处理特定文件类型。
• CODE_OF_CONDUCT.md, CONTRIBUTING.md: 社区行为准则和贡献指南，指导开发者的协作流程。
• README.md: 项目的主要说明文件，涵盖了安装、基本使用和特性概述。
• LICENSE: 明确项目采用的MIT许可证，规定了软件的使用、复制和分发条件。
• package.json, package-lock.json: 定义了项目的依赖项及其版本，以及可执行脚本和其他元数据。
• dprint.json: 配置代码格式化的规则。
• gulpfile.js: Gulp任务定义文件，用于自动化构建过程。
• CHANGELOG.md: 记录项目的重要更新和版本历史。

2. 启动文件介绍

在vscode-js-debug项目中，并没有直接提供一个“启动”文件供终端用户运行，因为这个项目主要是作为VS Code的扩展或者DAP服务器使用的。对于开发者想要测试或贡献代码，主要入口点可能是通过运行测试套件或构建VS Code扩展。若需构建或测试项目，一般会使用npm命令，例如，在根目录下运行npm install来安装依赖，随后可能使用如npm run watch或类似开发模式命令来监控源码变化并自动编译。

3. 项目的配置文件介绍

主要配置文件

• package.json: 这不仅包含项目的基本信息，如名称、作者、版本等，还定义了脚本命令（如构建、测试命令），项目依赖和开发依赖。

• .vscode/launch.json (虽然不直接包含于仓库但重要): 当在VS Code内使用此调试器时，开发者会在他们的本地项目中创建或编辑这个文件来设置调试配置。它定义了调试环境、启动参数、目标应用等。

• options.md: 在项目文档中提到，但不在仓库根目录直接提供，这个文件假设存在于项目某处，列举了可以在用户的VS Code launch.json配置中使用的各种选项，以便自定义调试行为。

配置这些文件是自定义调试体验的关键，允许用户指定调试目标（如Node.js、浏览器）、附加到正在运行的进程、设定断点、环境变量等。

请注意，实际操作中，如果你想在你的开发环境中配置或使用vscode-js-debug，你需要参考VS Code的官方文档和该扩展的本地文档来理解具体配置指令。