VSCode的调试配置launch.json怎么写？-VSCode-PHP中文网

VSCode的调试配置launch.json怎么写？

betcha

发布： 2025-10-14 22:56:02

原创

574人浏览过

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

vscode的调试配置launch.json怎么写？

写好 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 项目

白瓜面试

白瓜面试 - AI面试助手,辅助笔试面试神器

查看详情

{ "name": "调试 Node 应用", "type": "node", "request": "launch", "program": "${workspaceFolder}/app.js", "args": ["--port", "3000"], "env": { "DEBUG": "app:*" }, "console": "integratedTerminal" }

Python 脚本（需安装 Python 扩展）

{ "name": "调试 Python", "type": "python", "request": "launch", "program": "${workspaceFolder}/main.py", "console": "integratedTerminal", "args": ["arg1", "arg2"], "env": { "PYTHONPATH": "${workspaceFolder}" } }

前端代码调试（通过 Chrome 浏览器）

{ "name": "在 Chrome 中调试", "type": "pwa-chrome", "request": "launch", "url": "http://localhost:8080", "webRoot": "${workspaceFolder}/src" }

3. 实用技巧和注意事项

避免常见错误，提升调试效率。

确保已安装对应语言的调试扩展，比如 Node.js 需要内置支持，Python 需要官方 Python 扩展
使用变量如 ${workspaceFolder}、${file}、${fileBasename} 可提高配置通用性
调试 Express 或其他服务时，建议用 console: integratedTerminal，方便查看日志和交互
如果程序由外部启动（如 pm2 或 docker），应使用 request: attach 并指定端口
可以配置多个调试任务，通过 name 区分，比如“调试单元测试”、“启动 API 服务”等

基本上就这些。根据你的项目类型选择合适的 type 和参数，VSCode 通常能通过智能提示帮你补全字段。配置完成后，在调试面板选择对应项点击启动即可。

以上就是VSCode的调试配置launch.json怎么写？的详细内容，更多请关注php中文网其它相关文章！