答案是写好 launch.json 需明确程序类型和环境,配置 version、configurations 及其 name、type、request、program 等字段,按语言选择对应调试器并设置参数。

写好 VSCode 的 launch.json 文件,关键在于明确你要调试的程序类型和运行环境。这个文件位于项目根目录下的 .vscode 文件夹中,用于配置调试器的启动参数。
1. 基本结构和常用字段
launch.json 是一个 JSON 文件,包含一个或多个调试配置。基本结构如下:
{ "version": "0.2.0", "configurations": [ { "name": "启动调试", "type": "node", "request": "launch", "program": "${workspaceFolder}/index.js", "console": "integratedTerminal", "env": { "NODE_ENV": "development" } } ] }常见字段说明:
- name:调试配置的名称,出现在调试侧边栏下拉菜单中
- type:调试器类型,如 node、python、php、chrome 等
- request:请求类型,launch(启动程序)或 attach(附加到已运行进程)
- program:要运行的入口文件,通常用 ${workspaceFolder} 指向项目根目录
- args:传递给程序的命令行参数,数组形式
- cwd:程序运行时的工作目录
- env:环境变量设置
- console:控制台输出方式,可选 integratedTerminal(推荐)、internalConsole 或 externalTerminal
2. 不同语言的典型配置示例
根据你使用的语言,type 和参数会有所不同。
Node.js 项目
Python 脚本(需安装 Python 扩展)
{ "name": "调试 Python", "type": "python", "request": "launch", "program": "${workspaceFolder}/main.py", "console": "integratedTerminal", "args": ["arg1", "arg2"], "env": { "PYTHONPATH": "${workspaceFolder}" } } { "name": "在 Chrome 中调试", "type": "pwa-chrome", "request": "launch", "url": "http://localhost:8080", "webRoot": "${workspaceFolder}/src" }3. 实用技巧和注意事项
避免常见错误,提升调试效率。
基本上就这些。根据你的项目类型选择合适的 type 和参数,VSCode 通常能通过智能提示帮你补全字段。配置完成后,在调试面板选择对应项点击启动即可。










