launch.json文件

### 如何配置或使用 `launch.json` 文件 #### 什么是 `launch.json` `launch.json` 是 Visual Studio Code (VSCode) 的调试配置文件，用于定义调试器的行为和参数。它通常存储在项目的 `.vscode` 文件夹中。 要创建该文件，可以在 VSCode 中按下 **Ctrl + Shift + D** 或者通过菜单栏中的 **运行 -> 打开配置** 来启动调试视图，随后点击 **创建一个 launch.json 文件** 并选择目标编程语言环境[^1]。 #### 常见配置项 以下是常见的 `launch.json` 配置选项及其功能： 1. **name**: 调试配置名称，在启动调试时显示于列表中。 2. **type**: 使用的调试器类型（例如 node、dart、cpp 等）。 3. **request**: 请求模式，可以是 `"launch"` 表示直接启动程序进行调试，或者 `"attach"` 表示附加到已运行的进程上。 4. **program**: 待调试的目标程序路径。 5. **args**: 启动程序时传递给它的命令行参数数组。 6. **cwd**: 当前工作目录，指定此字段可确保调试过程中所有相对路径基于正确位置[^3]。 7. **preLaunchTask**: 在启动调试之前执行的任务名，需预先定义在 tasks.json 中。 8. **env**: 设置环境变量的对象字面量形式。 9. **console**: 控制台集成方式，比如内置终端 (`internalConsole`) 或外部终端 (`externalTerminal`)。 下面是一个简单的例子展示如何为 Node.js 应用编写 `launch.json`: ```json { "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "Launch Program", "skipFiles": ["<node_internals>/**"], "program": "${workspaceFolder}/app.js", "outFiles": [], "sourceMaps": true, "smartStep": true, "internalConsoleOptions": "openOnSessionStart" } ] } ``` 对于某些特定场景下的编码问题，也可以调整相关设置来解决字符集冲突等问题，如下所示的是针对中文环境下可能遇到的乱码情况所做的部分修改建议[^4]: ```json // settings.json { "files.encoding": "utf8", "terminal.integrated.defaultProfile.windows": "Git Bash", "terminal.integrated.profiles.windows": { "PowerShell": { "path": "pwsh.exe", "args": [] }, "Command Prompt": { "path": "cmd.exe", "args": ["/K", "chcp", "65001"] } } } ``` 以上代码片段展示了怎样更改默认编码以及终端编码至 UTF-8 ，从而避免因本地化原因产生的输出错误。 #### 注意事项 当手动编辑 `launch.json` 文件时，请务必小心语法准确性；任何拼写失误都可能导致无法正常加载配置甚至崩溃的情况发生。另外需要注意不同操作系统之间可能存在细微差异，因此跨平台项目应测试各端表现一致性。