launch.json中${workspacefolder}等变量解析失败的根本原因是文件未置于项目根目录的.vscode/子目录下；若位置错误，vscode会静默忽略该文件，导致所有变量为空，调试报“找不到文件”。
launch.json里${workspaceFolder}路径变量为什么总解析失败
根本原因不是变量写错了，而是launch.json没放在正确位置——它必须位于项目根目录下的.vscode/文件夹内。如果放在其他地方（比如用户目录或子目录），VSCode 会静默忽略，所有${workspaceFolder}、${file}等变量都变成空字符串，调试时直接报“找不到文件”或“无法启动程序”。
验证方式：打开命令面板（Ctrl+Shift+P），输入Developer: Toggle Developer Tools，在 Console 标签页里执行console.log(vscode.workspace.workspaceFolders)，若返回undefined，说明当前没打开有效工作区，变量自然无效。
-
launch.json必须放在.vscode/launch.json（即${workspaceFolder}/.vscode/launch.json） - 确保 VSCode 是通过
code .或双击文件夹方式打开整个项目，而不是只打开单个文件 - 多根工作区下，
${workspaceFolder}指向的是当前活动根目录，不是第一个根
调试时想用环境变量拼接路径，${env:HOME}和${userHome}有什么区别
${env:HOME}是读取系统真实环境变量，而${userHome}是 VSCode 自己推导的主目录路径，两者在大多数 Linux/macOS 下值相同，但在 Windows 上差异明显：
-
${env:HOME}在 Windows 默认为空（除非你手动设置了该环境变量） -
${userHome}在 Windows 上稳定返回C:\Users\用户名，不受系统变量影响 - 跨平台脚本中，优先用
${userHome}代替${env:HOME}，避免 Windows 下路径拼接失败
例如调试 Python 时想把日志写到用户目录："args": ["--log-dir", "${userHome}/myapp/logs"]比"${env:HOME}/myapp/logs"更可靠。
如何在 launch.json 中安全引用 settings.json 里的自定义配置
用${config:xxx}可以读取settings.json中的任意配置项，但必须确保该配置项已存在且类型匹配，否则变量展开为空，且不会报错。
- 先在
.vscode/settings.json里定义："myProject.buildDir": "dist" - 再在
launch.json中使用："program": "${workspaceFolder}/${config:myProject.buildDir}/main.js" - 如果
myProject.buildDir未定义，整个${config:...}部分会被删掉，导致路径变成${workspaceFolder}//main.js，引发错误 - 不支持嵌套写法，如
${config:myProject.${env:ENV_NAME}}是非法的，会原样保留字符串
调试 Node.js 时${file}和${relativeFile}选哪个更稳妥
取决于你的启动逻辑是否依赖工作区上下文。如果program指向的是当前编辑的文件，用${file}最直接；但如果项目用了ts-node或esbuild-node这类需要相对路径解析的运行时，${relativeFile}才能让模块导入正常工作。
-
${file}：绝对路径，适合直接执行已编译的 JS 文件，比如"program": "${file}" -
${relativeFile}：相对路径，适合 TypeScript 源码调试（配合ts-node），因为ts-node内部按相对路径解析import - 注意：
${relativeFile}在未保存的临时文件（如Untitled-1）中为空，此时调试会失败，建议加preLaunchTask确保文件已保存
真正容易被忽略的是：所有这些变量在调试器启动前就完成替换，它们不参与运行时逻辑，也不受env块里后续设置的影响——变量展开是一次性、静态的。如果你依赖动态路径（比如根据 Git 分支切不同配置），得换用${command:git.branch}这类命令变量，或者干脆写个 wrapper 脚本。
