vscode 的node.js debugger 的 launch.json 配置详细教程.zip

在开发JavaScript应用，尤其是Node.js应用时，Visual Studio Code（VSCode）是一个极其受欢迎的集成开发环境（IDE）。其中，其强大的调试工具是开发者的重要助手。这篇教程将深入讲解如何配置VSCode的`launch.json`文件，以充分利用Node.js调试器。 `launch.json`文件是VSCode调试配置的核心，它定义了调试会话的启动参数和行为。在VSCode中，你可以创建多个配置，以适应不同的调试需求，如调试本地应用、远程应用、单元测试等。这个教程的`launch.json`配置将专注于Node.js项目。 1. **创建`launch.json`文件** 当你在VSCode中首次尝试调试Node.js项目时，VSCode会自动生成一个`launch.json`文件。它通常位于`.vscode`目录下，如果该目录不存在，VSCode会自动创建。打开`launch.json`，你会看到一个JSON结构的配置文件，包含若干配置段。 2. **配置基本属性** - `name`: 显示在调试控制台的配置名称。 - `type`: 调试器类型，对于Node.js项目，应设置为`node`。 - `request`: 调试会话的请求类型，通常是`launch`（启动应用）或`attach`（附加到已运行的进程）。 - `program`: 指定要调试的主入口文件，如`index.js`。 - `cwd`: 指定调试会话的当前工作目录。 3. **高级配置** - `args`: 向Node.js进程传递的命令行参数。 - `env`: 定义环境变量，可覆盖系统环境变量。 - `outFiles`: 指定编译后的源码映射文件路径，用于源码级别的调试。 - `sourceMaps`: 如果你的项目使用了Babel或其他转换工具，启用此选项以匹配源码和转换后的代码。 - `internalConsoleOptions`: 控制调试控制台的行为，例如`openOnSessionStart`表示调试开始时打开控制台。 - `protocol`: 可选择`inspect`或`legacy`，用于指定Node.js进程的调试协议。 4. **调试特定场景** - **调试模块**：若需调试独立的模块，可通过`localRoot`和`remoteRoot`设置源代码的本地和远程路径。 - **调试单元测试**：配置`program`为测试运行器，如`mocha`，并添加`--debug-brk`参数以暂停在第一个断点。 - **调试NPM脚本**：配置`runtimeArgs`，如`npm run start --scripts-prepend-node-path`，以便调试NPM脚本。 5. **使用示例** 一个简单的`launch.json`配置可能如下所示： ```json { "version": "0.2.0", "configurations": [ { "name": "Launch Program", "type": "node", "request": "launch", "program": "${workspaceFolder}/index.js", "cwd": "${workspaceFolder}", "outFiles": ["${workspaceFolder}/dist/**/*.js"], "sourceMaps": true, "console": "internalConsole" } ] } ``` 6. **调试技巧** - **断点**：在源代码中设置断点，当调试会话启动时，程序会在这些点暂停。 - **变量查看**：在调试控制台中，你可以查看和修改变量值。 - **调用堆栈**：查看调用堆栈以了解函数调用关系。 - **Step In/Out/Over**：这些命令帮助你逐步执行代码，理解执行流程。 通过这个详细的`launch.json`配置教程，你应该能够更好地理解如何在VSCode中调试Node.js应用，并根据自己的需求进行定制。请参考提供的PDF文件，里面会有更详尽的步骤和示例，助你提升开发效率。