VS Code launch.json 怎样给多环境复用调试配置
来源:17golang原创
时间:2026-11-16 19:49:35 211浏览 收藏
VS Code 的多环境调试可以把公共路径写成 ${workspaceFolder},用 inputs 选择环境,再让 envFile 指向对应文件,少量差异放在 env 中覆盖。compounds 用于同时启动多个配置,不提供配置继承。下面以本地 Node.js 调试为例,不涉及远程生产环境。
官方地址:https://code.visualstudio.com/
调试配置文档:https://code.visualstudio.com/docs/debugtest/debugging-configuration
步骤一:打开项目并创建 launch.json
先准备已安装 Node.js 的本机环境。通过菜单 文件 → 打开文件夹 打开专用示例目录;在资源管理器中新建 server.cjs,粘贴下面的原创示例并保存。
// 此文件只展示环境值,便于比较两个调试会话
const environment = process.env.APP_ENV ?? 'unset';
const role = process.env.APP_ROLE ?? 'unset';
// 无网络监听或业务数据写入,继续运行后打印并退出
console.log({ environment, role });
点击活动栏的运行和调试图标,在侧栏点击创建 launch.json 文件,按提示选择 Node.js。若已有配置,使用菜单运行 → 打开配置打开现有文件。完成后,资源管理器应出现 .vscode/launch.json,编辑区显示配置内容,说明入口已就绪。

步骤二:填写可选择环境的 Node.js 配置
在 launch.json 编辑区,将示例内容替换为下面的完整 JSON。已有项目应合并数组条目,保留自己的配置。
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "应用:选择环境",
"program": "${workspaceFolder}/server.cjs",
"cwd": "${workspaceFolder}",
"envFile": "${workspaceFolder}/.env.${input:targetEnv}",
"env": {
"APP_ROLE": "debug-preview"
},
"console": "internalConsole",
"stopOnEntry": true
}
],
"inputs": [
{
"id": "targetEnv",
"type": "pickString",
"description": "选择调试环境",
"options": [
"dev",
"test"
],
"default": "dev"
}
]
}
program 指向同一个入口,cwd 固定项目目录;targetEnv 提供 dev 和 test 两个可选值;envFile 随选择指向 .env.dev 或 .env.test。Node.js 调试器的 env 会覆盖环境文件中的同名变量,因此这里明确将 APP_ROLE 设为 debug-preview。JSON 不支持注释,字段含义在此单独解释。
在资源管理器点击新建文件,分别建立以下两个根目录文件。不要把真实凭据填进这个示例。
.env.dev:
# 开发环境演示值,APP_ROLE 会被 launch.json 覆盖 APP_ENV=dev APP_ROLE=file-default
.env.test:
# 测试环境使用独立文件,字段保持相同 APP_ENV=test APP_ROLE=file-default
通过文件 → 全部保存保存。回到运行和调试侧栏,顶部配置下拉框应能选到“应用:选择环境”;资源管理器中两个环境文件与 server.cjs 均位于打开的根目录。这个状态意味着配置名已被识别,实际环境是否传入将在下一步观察。

变量参考:https://code.visualstudio.com/docs/reference/variables-reference
Node.js 调试参考:https://code.visualstudio.com/docs/nodejs/nodejs-debugging
步骤三:运行并观察环境,按需组合会话
在运行和调试 → 配置下拉框选“应用:选择环境”,点击旁边绿色开始调试按钮,或使用菜单运行 → 启动调试。在“选择调试环境”列表中选 dev。因为配置启用了 stopOnEntry,程序应先暂停在入口,编辑器出现暂停位置,调试工具栏可见。
点击调试工具栏的继续,通过菜单视图 → 调试控制台查看示例对象:environment 应为 dev,role 应为 debug-preview。再次启动并选 test,environment 应改为 test。示例没有持续服务,打印后退出是预期行为。这里描述的是读者操作后的预期,不是本机执行记录。

若要同时对照两个会话,可将 launch.json 改为下面的独立完整示例。它使用固定 env 值,便于区分会话;与前面的交互选择方案二选一即可。
{
"version": "0.2.0",
"configurations": [
{
"type": "node",
"request": "launch",
"name": "应用:开发",
"program": "${workspaceFolder}/server.cjs",
"env": {
"APP_ENV": "dev",
"APP_ROLE": "preview"
},
"stopOnEntry": true
},
{
"type": "node",
"request": "launch",
"name": "应用:测试",
"program": "${workspaceFolder}/server.cjs",
"env": {
"APP_ENV": "test",
"APP_ROLE": "preview"
},
"stopOnEntry": true
}
],
"compounds": [
{
"name": "开发与测试对照",
"configurations": [
"应用:开发",
"应用:测试"
],
"stopAll": true
}
]
}
这里两条配置分别命名为“应用:开发”和“应用:测试”,compound 通过这些名称引用它们。保存后在同一配置下拉框选择“开发与测试对照”,再点击开始调试。运行和调试侧栏的调用堆栈区域应能看到两个会话;选择不同会话观察各自变量。stopAll 让手动停止其中一个时一并停止该组合中的会话。
compound 的公共能力是组合启动,不会把父对象字段自动合并进各配置,也不保证一个服务先就绪另一个才启动。真正的多服务项目还需给实例安排独立端口;本例只打印环境,避免端口竞争干扰配置说明。
配置选择表与常见问题
| 需求 | 建议方式 | 需要记住 |
|---|---|---|
| 同一入口只运行一种环境 | inputs + envFile | 启动时选择环境 |
| 少量调试专用覆盖值 | env | 同名值覆盖环境文件 |
| 同时启动多个会话 | compounds | 引用配置名,不是继承 |
| 项目目录会变化 | workspaceFolder | 避免个人绝对路径 |
为什么换了 env 文件,运行值没有变化?
先看 env 中是否存在同名覆盖,再确认修改的是所选环境文件。已经运行的进程不会因文件保存自动获得新的进程环境,需停止后重新启动。
Python 或 Go 能直接照搬吗?
变量和组合的组织思路可以参考,但调试类型及环境字段支持由对应调试器决定。本文的 type、envFile 和运行观察以 Node.js 为范围。
能从另一条配置继承公共字段吗?
不要把 compounds 当作继承语法。少量配置可以接受显式重复;希望减少环境差异时,优先将差异集中到输入选择和环境文件。
-
482 收藏
-
447 收藏
-
397 收藏
-
236 收藏
-
452 收藏
-
152 收藏
-
368 收藏
-
文章 · 软件教程 | 13分钟前 | 开发工具 · vs code · 软件教程 · VS Code settings.json Workspace settings Settings editor 设置优先级327 收藏
-
117 收藏
-
338 收藏
-
228 收藏
-
159 收藏
-
429 收藏
-
172 收藏
-
486 收藏
-
216 收藏
-
320 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习