VSCode如何管理不同启动参数配置-VSCode-PHP中文网

vscode通过在launch.json中定义多个configuration对象来管理不同启动参数配置，每个对象需有唯一name，通过调试面板下拉菜单手动选择，不自动识别环境或读取.env文件。

vscode如何管理不同启动参数配置

直接说结论：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）：

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

{
  "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}"]
  }
]