VSCode工作区变量跨文件共享依赖launch.json变量机制与工作区配置协同，仅内置变量（如${workspaceFolder}、${env:VAR_NAME}）和inputs定义的自定义变量可在多个configuration中复用；${file}等上下文变量每次动态求值不可复用；多根工作区需严格匹配.code-workspace中folders的name字段；动态端口需通过tasks.json生成+command型input捕获实现统一注入。
VSCode工作区里怎么让变量在不同文件间共享？
VSCode 本身没有“全局变量”概念，所谓跨文件共享，本质是靠 launch.json 中的变量机制 + 工作区级配置协同实现。它不依赖运行时状态，而是编译期/启动期注入——也就是说，你改了变量值，得重启调试会话才生效。
哪些变量能在 launch.json 里跨 configuration 共享？
只有 VSCode 内置变量（如 ${workspaceFolder}、${env:PATH}）和通过 variables 定义的自定义变量能被多个 configurations 同时引用。但注意：${file}、${lineNumber} 这类上下文相关变量每次启动时动态求值，不能“复用”——它们不是存储值，而是占位符。
-
${workspaceFolder}指当前工作区根目录（不是单个文件夹），多根工作区下需配合命名使用，如${workspaceFolder:backend} -
${env:VAR_NAME}读取系统环境变量，启动 VSCode 前就得设好，终端里export VAR_NAME=xxx后再开 VSCode 才有效 -
${input:myPort}必须提前在inputs数组里声明，且类型为command或promptString，否则解析失败
为什么 ${workspaceFolder:xxx} 有时读不到？
因为命名必须严格匹配 .code-workspace 文件中 folders 数组里的 name 字段。大小写、空格、中文都算数——比如配置里写的是 "name": "API服务"，那你就得用 ${workspaceFolder:API服务}，写成 api-service 或漏掉“服务”两个字就返回空字符串。
- 路径字段
path可以是相对或绝对，但name是唯一标识符，不可重复 - 如果没定义
name，VSCode 自动用文件夹名填充，此时要用实际文件夹名（不含路径），例如./backend/api对应的 name 就是api - 调试启动时若看到
Cannot resolve '${workspaceFolder:xxx}'错误，八成是 name 不一致或工作区没保存为.code-workspace文件
如何让多个调试会话共用一个动态端口？
靠 tasks.json 配合 inputs 实现：先用 task 启动脚本生成随机端口并 echo 出来，再用 command 类型 input 捕获输出，最后在 launch.json 的多个 configuration 中引用该 input。
- 在
.vscode/tasks.json里定义一个 task，命令为node -e "console.log(Math.floor(Math.random()*1000)+3000)" - 在
launch.json的inputs里加一条：{"id":"dynamicPort","type":"command","command":"extension.commandvariable.process","args":{"command":"shell","shell":"node -e \"console.log(Math.floor(Math.random()*1000)+3000)\""}} - 然后在每个 configuration 的
port字段写${input:dynamicPort}——所有会话将拿到同一个端口号
这个链路里最容易断掉的一环是 command variable 扩展没装，或者 shell 命令路径不对；一旦报错 Command not found，就说明变量根本没注入进去。
