通过配置VSCode的launch.json可实现多环境调试。1. 使用env字段设置不同环境变量，如NODE_ENV区分开发、测试、生产环境；2. 利用configurationVariables和inputs定义可选参数，通过下拉菜单动态选择环境，减少配置重复；3. 可调用npm scripts复用现有启动命令，保持调试与运行一致。合理组织配置提升开发效率。
在使用 VSCode 进行开发时，配置 launch.json 是实现高效调试的核心手段。尤其在项目需要支持多个运行环境（如开发、测试、生产）时，合理组织调试配置能极大提升开发效率。下面介绍如何通过 .vscode/launch.json 实现多环境调试。
理解 launch.json 的基本结构
launch.json 文件位于项目根目录下的 .vscode 文件夹中，用于定义调试会话的启动参数。一个典型的配置包含以下关键字段：
-
name：调试配置的名称，显示在 VSCode 调试面板中
-
type：调试器类型，如
node、python、pwa-node 等
-
request：请求类型，
launch 表示启动程序，attach 表示附加到已运行进程
-
program：要运行的入口文件路径
-
env：环境变量，可用来区分不同运行环境
-
args：传递给程序的命令行参数
通过为不同环境设置独立的 env 或 args，就能实现多环境切换。
使用环境变量区分运行环境
最常见的做法是利用 env 字段注入不同的环境标识。例如，在 Node.js 项目中：
{
"version": "0.2.0",
"configurations": [
{
"name": "Dev Server",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/app.js",
"env": {
"NODE_ENV": "development",
"API_BASE_URL": "https://api.dev.example.com"
}
},
{
"name": "Test Server",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/app.js",
"env": {
"NODE_ENV": "test",
"API_BASE_URL": "https://api.test.example.com"
}
},
{
"name": "Production Simulation",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/app.js",
"env": {
"NODE_ENV": "production",
"API_BASE_URL": "https://api.example.com"
}
}
]
}
代码中可通过 process.env.NODE_ENV 判断当前环境，加载对应配置。
结合 configurationVariables 实现更灵活控制
如果多个配置重复度高，可以通过自定义变量减少冗余。VSCode 支持在 launch.json 中使用 configurationVariables 动态替换值：
LibLibAI
国内领先的AI创意平台，以海量模型、低门槛操作与“创作-分享-商业化”生态，让小白与专业创作者都能高效实现图文乃至视频创意表达。
下载
{
"version": "0.2.0",
"configurations": [
{
"name": "Run with ${input:envName}",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/app.js",
"env": {
"NODE_ENV": "${input:nodeEnv}",
"API_BASE_URL": "${input:apiUrl}"
}
}
],
"inputs": [
{
"type": "pickString",
"id": "envName",
"description": "Select environment",
"options": ["Development", "Testing", "Production"],
"default": "Development"
},
{
"type": "pickString",
"id": "nodeEnv",
"options": [
{ "label": "Development", "value": "development" },
{ "label": "Testing", "value": "test" },
{ "label": "Production", "value": "production" }
],
"default": "development"
},
{
"type": "pickString",
"id": "apiUrl",
"options": [
{ "label": "Dev API", "value": "https://api.dev.example.com" },
{ "label": "Test API", "value": "https://api.test.example.com" },
{ "label": "Prod API", "value": "https://api.example.com" }
],
"default": "https://api.dev.example.com"
}
]
}
这样只需维护一个调试配置，通过下拉菜单选择环境，避免重复定义。
调试脚本与 npm scripts 协同工作
若项目使用 npm scripts 启动不同环境，也可在 launch.json 中调用脚本：
{
"name": "npm run dev",
"type": "node",
"request": "launch",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"console": "integratedTerminal"
}
这种方式适合已有成熟脚本体系的项目，调试时直接复用现有命令，保持行为一致。
基本上就这些。通过合理配置 launch.json，你可以轻松在不同环境间切换调试，无需手动修改代码或环境变量。关键是根据项目实际需求选择合适的方式：简单项目用多个独立配置，复杂项目可结合 input 变量提升灵活性。
