vscode调试配置不生效主因是作用域错误：launch.json仅在当前工作区生效，用户设置仅影响通用行为；需检查作用域、文件路径、configurations结构、env/args路径转义、prelaunchtask匹配及变量定义。
调试配置项改了不生效？先确认作用域层级
VSCode的调试配置（launch.json）修改后不生效，90%的情况是作用域写错了。它只在当前工作区（.vscode/launch.json）或用户全局（settings.json里带debug.前缀的选项）生效，但后者仅影响通用行为，比如debug.console.fontSize，不能替代launch.json里的具体启动参数。
常见错误：把项目级的program路径写进用户设置，或者误删了configurations数组里的某个name字段导致整个配置块被忽略。
- 打开调试视图（
Ctrl+Shift+D），确认左上角显示的是“当前工作区”而非“用户” - 检查
.vscode/launch.json是否在项目根目录，且文件名全小写、无空格或隐藏字符 - 如果使用多配置，确保
configurations是数组，每个对象都有name和type字段
动态修改env和args时的路径与转义陷阱
env和args是调试中高频修改的字段，但它们对路径分隔符、空格、引号极其敏感。Windows下用反斜杠\不加引号会直接报错；Linux/macOS下含空格的路径不加双引号会被截断。
例如，在C++调试中传参："args": ["--input", "data/file.txt"]是安全的；但写成"args": ["--input data/file.txt"]就会让程序收到一个参数而非两个。
-
env中的路径变量（如PATH或自定义MY_LIB_PATH）必须用${workspaceFolder}等变量，避免硬编码绝对路径 - Windows下若需调用批处理或PowerShell脚本，
args里不要用单引号，统一用双引号 - 调试Node.js时，
env.NODE_OPTIONS若含空格（如--inspect=0.0.0.0:9229），整个值必须包裹在双引号内
修改preLaunchTask后调试启动失败
preLaunchTask不是简单指向一个任务名，它依赖tasks.json中对应label的精确匹配，且该任务必须声明"type": "shell"或"type": "process"，否则调试器无法等待其完成。
典型失败现象：控制台一闪而过，调试直接跳过构建步骤，报错Cannot launch program; program does not exist。
- 检查
.vscode/tasks.json中目标label是否与launch.json里写的完全一致（区分大小写） - 确保任务有
"group": "build"或显式"isBackground": false，否则调试器可能不等待 - 若任务输出路径含中文或特殊符号，
preLaunchTask仍能触发，但后续program路径解析会失败——此时应优先在tasks.json里用${fileDirname}生成路径，而非硬写
热更新调试配置：不用重启VSCode
VSCode本身不支持launch.json热重载，但你可以绕过重启实现“伪动态”：只要保存launch.json后，再手动点击调试面板顶部的“重新加载”按钮（或按Ctrl+Shift+P执行Developer: Reload Window），就能立即应用新配置。不过更轻量的做法是——利用配置变量。
例如，把频繁变动的路径抽出来："program": "${config:myApp.executable}"，然后在settings.json里加一行"myApp.executable": "./build/app"。改路径只需改settings.json，无需碰launch.json。
- 变量支持链式引用，比如
${config:myApp.buildDir}/app，前提是myApp.buildDir已在设置中定义 - 注意
config:变量只能读取settings.json，不能读取环境变量或系统变量 - 调试器启动时若提示
Variable 'xxx' not found，说明变量名拼错或未定义，而不是配置没生效
export MY_VAR=1，launch.json里的env也不会自动包含它——所有依赖必须显式声明。
