首先创建launch.json文件以配置调试环境,vscode通过该文件定义程序启动方式;接着选择node.js等环境生成基础配置,包含name、type、program等关键字段;最后设置断点并启动调试,程序将在断点处暂停,支持变量查看与逐行执行。

调试是开发过程中不可或缺的一环。VSCode 提供了强大的调试功能,通过配置 launch.json 文件,你可以轻松启动和控制程序的执行流程。下面带你一步步创建并运行你的第一个 launch.json,快速上手 VSCode 调试。
理解 launch.json 的作用
launch.json 是 VSCode 中用于定义调试配置的文件。它告诉编辑器:你要调试什么程序、使用哪种环境、传入哪些参数、是否自动重启等。
每个项目可以在 .vscode 文件夹下放置这个文件,VSCode 读取后会在调试面板中显示可选的启动配置。
创建 launch.json 的步骤
以 node.js javaScript 调试为例,演示如何创建你的第一个调试配置:
- 打开你的项目文件夹(确保已用 VSCode 打开)
- 点击左侧活动栏的虫子图标(调试视图)
- 点击“运行和调试”上方的“create a launch.json file”链接
- 选择环境,比如 Node.js
- VSCode 会自动生成一个基础的
launch.json文件
生成的内容类似如下:
{ “version”: “0.2.0”, “configurations”: [ { “name”: “Launch Index with Node”, “type”: “node“, “request”: “launch”, “program”: “${workspaceFolder}/index.js”, “console”: “integratedTerminal” } ] }
关键字段说明
了解常用配置项,有助于你按需修改:
- name:在调试下拉菜单中显示的名称
- type:调试器类型,如
node、python、cppdbg等 - request:请求类型,
launch表示启动程序,attach表示附加到已运行进程 - program:要运行的入口文件,
${workspaceFolder}指当前项目根目录 - console:指定输出方式,
integratedTerminal可与程序交互
运行你的第一个调试配置
完成配置后,调试就可以开始了:
- 确保你的项目中有一个
index.js文件(或修改配置指向实际文件) - 在代码中设置一个断点(点击行号左侧)
- 回到调试面板,选择刚创建的配置
- 点击绿色三角按钮或按 F5 启动调试
程序会在断点处暂停,你可以查看变量、调用栈、逐行执行等。
基本上就这些。只要有了 launch.json,调试就变得直观又高效。不同语言插件可能提供不同的调试支持,但流程大体一致——创建配置、设断点、启动调试。不复杂但容易忽略细节,比如文件路径写错或运行环境未安装。确认好这些,调试就能顺利进行。


