首页 > 开发工具 > VSCode > 正文

解密VS Code的launch.json:所有调试配置的起点

P粉986688829
发布: 2025-12-04 20:09:07
原创
769人浏览过
launch.json是VS Code调试功能的核心配置文件,用于定义启动方式、目标、参数及断点位置;由编辑器根据工作区和已安装调试扩展自动生成,包含name、type、request等关键字段,支持多配置共存与快速切换。

解密vs code的launch.json:所有调试配置的起点

VS Code 的 launch.json 是调试功能的核心配置文件,它告诉编辑器“怎么启动、连谁、传什么参数、停在哪”。没有它,点击 ▶️ 调试按钮就只会提示“找不到调试配置”。

launch.json 从哪来?

它不是凭空出现的,而是由 VS Code 根据当前工作区和已安装的调试器扩展自动生成的模板。常见触发方式:

  • Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Debug: Open launch.json,选择环境(如 Node.js、Python、Go)
  • 首次点击调试侧边栏的“运行和调试” → “创建 launch.json 文件”,再选环境
  • 打开一个含调试扩展支持的项目(比如有 package.json 的 Node 项目),VS Code 可能主动建议生成

核心字段一眼看懂

每个配置(configurations 数组中的一项)至少包含三个关键字段:

  • name:调试配置的名字,显示在调试下拉菜单里,比如 "Launch Program"
  • type:调试器类型,必须与已安装的扩展匹配,例如 "node""python""cppdbg"
  • request:请求模式,常见值是 "launch"(本地启动)或 "attach"(附加到已有进程)

其他高频字段:program(要运行的入口文件)、args(命令行参数)、env(环境变量)、cwd(工作目录)、preLaunchTask(启动前执行的任务,如编译)。

多环境共存不打架

一个 launch.json 可以同时定义多个配置,用不同 name 区分。比如:

Riffo
Riffo

Riffo是一个免费的文件智能命名和管理工具

Riffo 216
查看详情 Riffo
  • "Debug Server" — 启动 Express 后端,监听 3000 端口
  • "Debug Client" — 启动前端开发服务器,开浏览器
  • "Attach to Process" — 附加到正在运行的 Node 进程 PID

切换时只需在调试控制栏顶部下拉菜单选对应名字,VS Code 自动加载该配置的全部参数。

常见问题一查就灵

调试失败?先盯这几个地方:

  • 路径写错:比如 "program": "./src/index.js",但文件实际在 ./lib/index.js,或没加 ./ 导致被当成模块名
  • type 不匹配:写了 "type": "python" 却没装 Python 扩展,或装了但没启用
  • 端口被占"port" 字段(如用于 attach)指定的端口已被其他程序占用
  • 断点不生效:确认源码映射是否正确(尤其 TypeScript 或打包后代码),检查 sourceMapsoutFiles 配置

基本上就这些。launch.json 不复杂,但它是调试行为的唯一开关——配对了,一切顺;漏一项,就卡住。

以上就是解密VS Code的launch.json:所有调试配置的起点的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号