preLaunchTask字段必须与tasks.json中对应任务的label值完全一致（含大小写、空格、标点），且任务需为shell类型、可独立运行并正常退出；调试前须手动刷新任务配置。
preLaunchTask 字段必须匹配 tasks.json 中的 label
VSCode 调试器启动前执行任务，靠的是 launch.json 里的 preLaunchTask 字段。它不是随便写个命令名就能生效的——必须和 .vscode/tasks.json 里某个任务的 label 完全一致（包括大小写、空格、标点）。常见错误是：tasks.json 里写的是 "label": "build"，而 launch.json 里填了 "preLaunchTask": "npm run build" 或 "build:dev"，结果调试器静默跳过，连终端都不弹。
实操建议：
- 打开
.vscode/tasks.json，确认你要触发的任务有明确、简洁、无歧义的label，比如"build"或"prepare-env" - 在
launch.json的配置项中，直接复制粘贴该label到preLaunchTask字段 - 如果 label 含空格（如
"Build and test"），必须原样保留；VSCode 不做 trim 或模糊匹配
任务必须定义为 shell 类型且可独立运行
preLaunchTask 只会等待任务完成（即进程退出码为 0），不会解析输出或处理交互。所以它不兼容需要用户输入、持续后台运行、或依赖终端交互的任务。典型踩坑场景：
- 用
"type": "process"起一个长期监听的服务（如nodemon），调试器会卡住，因为进程没退出 - 命令里含
read -p或pause，任务永远不结束，F5 就挂起 - 在 Windows 上用
command直接写set VAR=xxx & npm run dev，shell 解析失败，任务报错退出
正确做法是：
- 统一用
"type": "shell" - 把多步操作写进脚本文件（
scripts/prepare.sh或scripts/prepare.bat），再让command调用它 - 确保脚本最后以
exit 0显式收尾（尤其 PowerShell 脚本容易忽略）
Windows 下 cmd / PowerShell / Git Bash 的路径与环境差异
同一份 tasks.json 在不同终端下行为可能不一致。比如你在 Git Bash 里能跑通的 export NODE_ENV=development，在默认 Windows Terminal（cmd.exe）里就报错。VSCode 默认用系统 shell，但 preLaunchTask 实际执行时受 terminal.integrated.defaultProfile.* 和任务自身的 options.shell 影响。
关键控制点：
- 检查
settings.json是否覆盖了终端 profile，例如"terminal.integrated.defaultProfile.windows": "Git Bash" - 在 task 定义里显式指定 shell：添加
"options": { "shell": { "executable": "C:\Program Files\Git\bin\bash.exe", "args": ["--login", "-i", "-c"] } } - 避免跨 shell 的语法混用：不要在
args数组里塞 bash 特有符号（如$()），改用command字符串 +shell指定解释器
调试器启动失败时，先看“调试控制台”而非“终端”
很多人发现 preLaunchTask 没执行，第一反应是翻集成终端——但 VSCode 其实把任务执行日志和调试器初始化错误分开了。真正有用的线索藏在“调试控制台”（Debug Console）里，尤其是这三类信息：
-
Could not find the task 'xxx'→ label 名字对不上，或 tasks.json 格式错误（比如多逗号、少引号） -
Task xxx terminated with exit code 1→ 任务本身失败，要回看终端输出（注意：不是调试控制台，是“终端”面板里对应的那个 Shell 标签页） -
Timeout waiting for preLaunchTask→ 任务卡死，大概率是用了阻塞型命令（如npm run dev）没加--no-watch或后台化
最容易被忽略的一点：VSCode 不会自动重载 tasks.json。改完配置后必须手动关闭再重新打开文件夹，或者按 Ctrl+Shift+P 运行 Tasks: Manage Automatic Tasks 触发一次刷新，否则新任务根本不在候选列表里。
