VS Code调试完全手册：从launch.json开始

launch.json是VS Code项目级调试配置文件，存于.vscode/下，定义启动方式、环境变量等；核心字段包括type、request、name、program、args、env；配置错误会导致断点失效等问题。

VS Code 的调试能力非常强大，但真正用起来顺手，关键不是点“开始调试”按钮，而是理解 launch.json 这个配置文件——它才是调试行为的“总开关”。没配对，断点不生效、变量看不到、程序起不来，都是常事。

launch.json 是什么，为什么绕不开

它是 VS Code 项目级的调试配置文件，存放在 .vscode/launch.json 下。VS Code 不会自动猜你想怎么跑代码：是直接执行 Python 脚本？还是 attach 到一个已运行的 Node.js 进程？是否要传命令行参数？环境变量设哪些？这些全靠它定义。没有它，调试器连“启动方式”都不知道。

生成方式很简单：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Debug: Open launch.json，选对应环境（如 Python、Node.js、Go），VS Code 就会自动生成一个基础模板。

核心字段一学就会

一个典型配置里，这几个字段最常用也最关键：

小云雀

剪映出品的AI视频和图片创作助手

1587

查看详情

• type：调试器类型，比如 python、node、go，必须和已安装的调试扩展匹配
• request：取值通常是 launch（启动新进程）或 attach（连接已有进程），别写反
• name：调试配置的名字，会显示在 VS Code 顶部的调试下拉菜单里，建议起得具体点，比如 Launch server.py with --debug
• program（Python/Node 常用）：要运行的入口文件路径，支持相对路径，如 "${workspaceFolder}/src/main.py"
• args：命令行参数数组，例如 ["--port", "8080", "--env", "dev"]
• env：环境变量对象，比如 {"PYTHONPATH": "${workspaceFolder}/lib"}，注意变量值里可用 ${...} 变量语法

常见问题现场解决

断点灰色、控制台没输出、提示 “Cannot launch program”？大概率是这几个地方出错了：

• 检查 program 路径是否存在、拼写是否正确，特别是大小写和斜杠方向（Windows 用 / 或 \ 都行，但别混用）
• 确认已安装对应语言的调试扩展（如 Python 扩展含 debugpy；Node.js 需装官方 “Debugger for Edge” 或 “JavaScript Debugger”）
• 如果用 attach 模式，确保目标进程已启动且开启了调试端口（如 Node 加了 --inspect=9229）
• 多配置时，务必在 VS Code 顶部调试下拉菜单中选对 name，否则点错就白忙活

进阶技巧让调试更省心

小改动，效率翻倍：

• 用 preLaunchTask 自动构建：比如调试前先执行 npm run build，避免手动编译遗漏
• 加 console: "integratedTerminal"，让程序输出直接在 VS Code 终端里跑，方便看日志、输交互内容
• 设置 justMyCode: false（Python）可进入标准库源码调试；skipFiles（Node）跳过 node_modules，聚焦业务逻辑
• 多个 configurations 可共存，比如一个本地开发，一个连接测试服务器，切换即用

基本上就这些。launch.json 看似是配置文件，实则是你和调试器之间的“协议说明书”。配清楚，调试就从玄学变确定性操作。

以上就是VS Code调试完全手册：从launch.json开始的详细内容，更多请关注php中文网其它相关文章！