VS Code launch.json 怎么为不同环境配置调试参数

在同一个项目里切换开发环境和测试环境，最容易踩的坑是把端口、入口文件和个人绝对路径散落在启动命令里。更稳妥的做法是把每套调试参数保存到工作区的 .vscode/launch.json，在 Run and Debug 面板选择配置后再按 F5。下面用两项 Node.js 风格配置演示完整路径；如果你使用 Go、Python 或 PHP，只需要把 type 和调试器专属字段换成对应扩展支持的值。

一、先从 Run and Debug 建立配置入口

先用 VS Code 打开项目文件夹。点击左侧活动栏的 Run and Debug，在面板中选择 Create a launch.json file，再选择项目对应的调试器。VS Code 会在项目根目录创建 .vscode/launch.json；配置下拉菜单中的选项，来源就是文件里的 configurations 数组。

如果看不到创建入口，先确认当前窗口打开的是文件夹而不是单个文件；没有工作区时，简单文件可以直接调试，但不能完整管理工作区级 launch 配置。

二、用两项配置区分开发和测试环境

打开 Explorer 中的 .vscode/launch.json，保留一个清楚的 name，再复制出第二项配置。下面示例用 env 传入端口，用工作区变量拼接入口文件。JSON 本身不写注释，字段含义放在代码块后说明。

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Development",
      "program": "${workspaceFolder}/app.js",
      "cwd": "${workspaceFolder}",
      "env": { "APP_ENV": "development", "APP_PORT": "3000" },
      "args": ["--port", "${env:APP_PORT}"]
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Test",
      "program": "${workspaceFolder}/app.js",
      "cwd": "${workspaceFolder}",
      "env": { "APP_ENV": "test", "APP_PORT": "4000" },
      "args": ["--port", "${env:APP_PORT}"],
      "stopOnEntry": true,
      "windows": { "console": "integratedTerminal" }
    }
  ]
}

type、request、name 是每项配置的基础字段；program 指向入口，cwd 决定相对路径的工作目录，args 是传给程序的参数，env 则只作用于本次调试进程。这里的 ${env:APP_PORT} 读取当前调试环境中的变量，若希望固定使用每项配置自己的端口，也可以直接写成 3000 与 4000。

保存后按 Run and Debug → 配置下拉菜单，应能看到 Development 和 Test。若出现红色波浪线，把光标放在对应字段上按 IntelliSense 提示修正；不同调试扩展支持的字段并不完全相同。

三、启动后用断点和 Debug Console 验收

1. 选择配置：点击 Run and Debug → 配置下拉菜单，选 Test。
2. 设置断点：打开入口文件，在目标行号左侧单击，看到红色圆点后按 F5 或点击 Start Debugging。
3. 检查状态：程序停住后查看 CALL STACK 和 VARIABLES，再打开底部 Debug Console 检查端口或环境输出。

真正能证明配置生效的不是“没有报错”，而是当前状态栏显示了选中的配置，程序确实在断点暂停，并且调试面板里的变量与所选环境一致。切回 Development 重启一次，端口和 APP_ENV 应随配置改变。

四、平台覆盖和失效排查

Windows、Linux 和 macOS 的路径或控制台确实不同，再在配置内部添加 windows、linux 或 osx。平台块中的同名属性会覆盖全局值，但 type 不应放进平台块。不要为了迁就某台电脑把 C:\Users\某人\... 写进共享配置，优先使用 ${workspaceFolder}。

• 下拉菜单为空：检查是否打开了项目文件夹、launch.json 是否有 JSON 语法错误。
• 字段变红：确认调试扩展的 type，再按 IntelliSense 查看该扩展实际支持的属性。
• 端口没有变化：确认 args 引用的变量名和 env 中的键一致，并重启调试会话。
• 断点空心或不命中：先看入口文件、源映射和调试扩展状态；这通常不是配置下拉菜单本身的问题。

常见问题

launch.json 能不能放多个环境？

可以。把多个对象放进同一个 configurations 数组，用不同的 name 区分；每次启动前从 Run and Debug 下拉菜单选择目标项。

${workspaceFolder} 和绝对路径有什么区别？

前者会根据当前工作区解析，适合提交给团队共享；绝对路径只对某台机器稳定，换目录或换成员后容易失效。

什么时候需要 attach 而不是 launch？

launch 负责按配置启动程序，attach 用于程序已经运行、调试器再连接进去的场景。先判断进程由谁启动，再选择请求类型。

最后按 Run and Debug → Test → Start Debugging 复查一次：配置名称正确、断点能停、Debug Console 有输出，且项目中没有个人绝对路径，这套 launch.json 才算真正可交接。