VSCode通过在launch.json中定义多个configuration对象来管理不同启动参数配置，每个对象需有唯一name，通过调试面板下拉菜单手动选择，不自动识别环境或读取.env文件。
直接说结论：VSCode 用 launch.json 管理不同启动参数配置，不是靠“切换环境”按钮，而是靠定义多个 configuration 对象，再手动选。 它不自动识别 dev/prod，也不读取 .env 文件（除非你显式配置），所有差异都得写进 JSON 字段里。
launch.json 里怎么定义多个启动配置
一个 launch.json 可以包含多个 configuration，每个对象代表一种启动方式。VSCode 调试面板顶部的下拉菜单就是从这里读出来的。
关键点：
- 每个
configuration必须有唯一name，比如"name": "Debug Dev"和"name": "Debug Prod" -
type和request必须匹配运行时（如"type": "node"+"request": "launch"） -
args、env、program这些字段可以完全不一样，实现参数隔离 - 不要在同一个配置里用条件判断——JSON 不支持 if/else，想动态就得拆成多个配置
示例（Node.js）：
{
"version": "0.2.0",
"configurations": [
{
"name": "Debug Dev",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/src/index.js",
"args": ["--port", "3000"],
"env": { "NODE_ENV": "development" }
},
{
"name": "Debug Prod",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/dist/index.js",
"args": ["--port", "8080"],
"env": { "NODE_ENV": "production" }
}
]
}
Java 多模块项目必须配 projectName 和 env
对 Maven 多模块项目，光改 args 和 env 不够。不指定 projectName，调试器会猜错模块；不设 env 激活 profile，Spring Boot 就加载不到 application-prod.yml。
常见错误现象：
-
ClassNotFoundException：projectName没写，或写错了大小写（Maven 模块名区分大小写） -
APPLICATION FAILED TO START：没通过env设置SPRING_PROFILES_ACTIVE - 启动了 A 模块，但你想调的是 B 模块：只改了
mainClass，没同步改projectName
正确写法（Spring Boot 启动模块叫 web-start）：
{
"name": "Debug web-start (prod)",
"type": "java",
"request": "launch",
"mainClass": "com.example.WebStartApplication",
"projectName": "web-start",
"env": {
"SPRING_PROFILES_ACTIVE": "prod",
"JAVA_HOME": "/opt/java/jdk-17"
}
}
动态参数别硬编码，用 ${input:xxx} 配 inputs
如果每次调试都要换端口、改日志级别，把值写死在 args 里会很快失控。VSCode 支持运行时弹窗输入，比复制粘贴安全又省事。
操作要点：
-
args中用"${input:port}"占位，不是"${port}"或"$port" -
inputs必须和configurations同级，不能嵌在某个 configuration 里 -
promptString是自由输入，pickString是下拉选择，后者更适合固定选项（如环境名） - Windows 上路径分隔符建议统一用
/，避免\被转义出错
示例片段：
"inputs": [
{
"id": "port",
"type": "promptString",
"description": "端口号",
"default": "8080"
}
],
"configurations": [
{
"name": "Debug with custom port",
"type": "node",
"request": "launch",
"program": "${workspaceFolder}/index.js",
"args": ["--port", "${input:port}"]
}
]
跨平台路径和 JDK 版本容易被忽略
团队协作时，launch.json 提交到 Git，但 Windows 用户的 JAVA_HOME 和 macOS 用户的路径结构完全不同。硬写绝对路径等于埋雷。
更隐蔽的问题是：type: java 配置默认使用 VSCode Java 扩展识别的 JDK，但如果项目要求 JDK 17，而用户本地只有 JDK 21，就会静默失败——控制台可能只显示 “Launching…” 然后卡住，连错误都不报。
稳妥做法：
- 用
${env:JAVA_HOME}引用系统变量，而不是写死/Library/Java/.../jdk-17.jdk - 在
settings.json里加"java.configuration.runtimes"显式声明支持的 JDK 版本，让语言服务器提前校验 - 避免在
env里覆盖JAVA_HOME，除非你确定所有成员都装了同一路径的 JDK - Linux/macOS 下注意
file:///URI 格式，Windows 下用file://（少一个斜杠）
真正麻烦的不是配错一次，而是多人共用一份 launch.json 时，没人意识到自己改的路径在别人机器上根本不存在。
