launch.json是VS Code调试功能的核心配置文件，用于定义启动方式、目标、参数及断点位置；由编辑器根据工作区和已安装调试扩展自动生成，包含name、type、request等关键字段，支持多配置共存与快速切换。

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 区分。比如：

星辰Agent

科大讯飞推出的智能体Agent开发平台，助力开发者快速搭建生产级智能体

378 查看详情

• "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 或打包后代码），检查 sourceMaps 和 outFiles 配置

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

以上就是解密VS Code的launch.json：所有调试配置的起点的详细内容，更多请关注其它相关文章！

# linux  # python  # js  # 前端  # node.js  # json  # node  # go  # typescript  # windows  # 浏  # 命令行  # 让你  # 鼠标  # 编辑器  # 自动生成  # 配置文件  # 调试器  # 专注于  # 首次  # 多个  # 兰蔻网站建设路  # 咸宁市网站建设空间优化  # 北辰网站seo推广咨询  # 东莞凤岗网站推广  # 亿源科技网站建设  # 网站推广找工作  # 嘉兴seo优化方式  # 专科医院网站推广策略  # 鬼网站建设路  # 广州网站建设推广哪家好