vscode工作区变量是按规则自动解析的字符串占位符，仅在特定配置文件的指定字段生效：launch.json全部字段、tasks.json的command/args/options、settings.json中部分扩展项等；${workspacefolder}恒指工作区根目录，${fileworkspacefolder}仅在打开文件时返回其所属子项目路径。
VSCode 的工作区变量不是“管理”出来的，而是按规则自动解析、在特定配置文件里才生效的字符串占位符。你不能在 settings.json 里定义新变量，但可以安全使用预定义变量（如 ${workspaceFolder}）来写跨平台、可复用的路径配置；错用位置或上下文会导致变量不展开、路径报错甚至调试失败。
哪些文件支持 ${xxx} 变量替换
变量只在明确支持的位置起作用，不是所有 JSON 字段都能用：
-
launch.json：全部字段基本都支持，包括program、cwd、envFile、environment.value -
tasks.json：仅command、args、options支持；inputs或label里写${file}会原样保留，不解析 -
settings.json：极有限 —— 仅部分扩展配置项支持，比如python.defaultInterpreterPath、eslint.workingDirectories；但files.exclude或editor.fontSize写变量会直接报错或忽略 -
c_cpp_properties.json：includePath、defines等字段支持，是 C/C++ 扩展明确声明的
${workspaceFolder} 和 ${fileWorkspaceFolder} 到底差在哪
这两个最常用却最容易混用。关键区别不在“有没有 file”，而在“当前上下文是否已打开文件”：
-
${workspaceFolder}：永远指向工作区根目录（即.code-workspace文件所在目录），不管有没有打开文件、打开哪个文件 -
${fileWorkspaceFolder}：只在**已打开某个文件**时才有值，且返回该文件所属的 workspace folder —— 这对多根工作区（multi-root workspace）至关重要 - 举例：工作区含两个文件夹
./backend和./frontend，你正编辑frontend/src/index.ts：
→${workspaceFolder}是/path/to/my-team（.code-workspace 所在目录）
→${fileWorkspaceFolder}是/path/to/my-team/frontend - 调试时若漏写
cwd，Node.js 进程默认在${workspaceFolder}启动，可能找不到frontend/.env—— 此时必须用${fileWorkspaceFolder}或显式写${workspaceFolder:frontend}
为什么 ${env:XXX} 在 settings.json 里有时不生效
不是语法错，而是 VSCode 对环境变量的引用有严格限制：
- 只在**扩展明确支持**的设置项中可用，例如：
"python.pythonPath": "${env:PYTHON_PATH}"可行，但"files.autoSave": "${env:AUTO_SAVE_MODE}"会静默失败 - 环境变量必须在 VSCode **启动前**就存在；通过终端执行
export VAR=1 && code .有效，但在 VSCode 内部终端里export不会影响编辑器自身进程 - Windows 上注意大小写：PowerShell 设置
$env:MY_VAR="x"，但 VSCode 读取时仍要用${env:MY_VAR}，小写名（如my_var）在 Windows 下通常无法匹配 - 敏感值（如 API key）绝不要硬编码进
settings.json；应走envFile+launch.json注入，或用${config:mySecret}配合用户级加密存储（需扩展支持）
多根工作区下怎么精准定位子项目路径
靠 ${workspaceFolder} 不够，必须用带名字的变量语法 ${workspaceFolder:xxx}：
- 先确认
.code-workspace中folders数组里每个条目是否定义了name字段："folders": [{ "name": "backend", "path": "../backend" }, { "name": "frontend", "path": "../frontend" }] - 在
launch.json的configuration中：
→"cwd": "${workspaceFolder:backend}"确保进程工作目录是 backend 根
→"envFile": "${workspaceFolder:frontend}/.env.local"指向 frontend 的环境文件 - 没写
name？VSCode 会 fallback 到文件夹 basename，但一旦路径含空格或特殊字符（如my app），${workspaceFolder:my app}会解析失败 —— 所以务必显式命名 -
${relativeFile}在多根工作区中始终相对于它所属的workspaceFolder，不是整个工作区根；这点和单文件夹工作区行为一致
变量本身没有“状态”或“生命周期”，它的值完全取决于当前编辑器上下文（是否打开文件、打开哪个文件、工作区结构、启动方式）。最常被忽略的是：变量只在解析那一刻求值，不会随文件切换或环境变量变更而动态更新 —— 调试配置一旦启动，${env:PATH} 就固定了，改系统环境变量也无效，必须重启调试会话。
