VS Code launch.json 怎样给多环境复用调试配置
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 当作继承语法。少量配置可以接受显式重复;希望减少环境差异时,优先将差异集中到输入选择和环境文件。
VS Code 怎样为不同项目切换独立配置档案
- 上一篇
- VS Code 怎样为不同项目切换独立配置档案
- 下一篇
- VS Code 设置优先级怎样定位项目配置被用户设置覆盖
-
- 文章 · 软件教程 | 10分钟前 | vs code · 软件教程 · 编辑器 VS Code 代码折叠 Fold Level
- VS Code 怎样用折叠级别快速收起嵌套代码
- 152浏览 收藏
-
- 文章 · 软件教程 | 12分钟前 | vs code · 软件教程 · VS Code tasks.json 任务变量 inputs
- VS Code 任务怎样用输入变量减少重复命令
- 368浏览 收藏
-
- 文章 · 软件教程 | 13分钟前 | 开发工具 · vs code · 软件教程 · VS Code settings.json Workspace settings Settings editor 设置优先级
- VS Code 设置优先级怎样定位项目配置被用户设置覆盖
- 327浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- Docker Compose检查端口与网络解析
- 338浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- Docker Compose init怎样回收容器里的子进程
- 228浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- Docker Compose events怎样实时查看服务状态变化
- 159浏览 收藏
-
- 文章 · 软件教程 | 1天前 | 私有仓库 · ssh · docker 私有仓库 BuildKit Docker Buildx SSH挂载
- Docker BuildKit用SSH挂载私有仓库
- 429浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- Docker Compose up只重建指定服务
- 172浏览 收藏
-
- 文章 · 软件教程 | 1天前 | docker · build Docker Compose no-cache 重建镜像
- Docker Compose build关闭缓存重建镜像
- 486浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- Docker Compose config查看变量展开结果
- 216浏览 收藏
-
- 文章 · 软件教程 | 1天前 | docker · 容器存储 临时目录 Docker Compose tmpfs Compose服务
- Docker Compose怎样用tmpfs挂载临时目录
- 320浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1054次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1054次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1215次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1161次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1004次使用
-
- 从Node.js 转到 Go平台
- 2022-12-23 482浏览
-
- B站等视频网站的弹幕用的是 websocket 还是轮询?
- 2023-02-16 447浏览
-
- Node 如何以最简短的代码跑满 CPU
- 2023-01-12 397浏览
-
- 关于微信支付
- 2023-01-08 236浏览
-
- http请求建立连接的时候为啥是tcp三次握手,而不是二次或者四次?
- 2023-02-24 452浏览

