VSCode中dependsOn必须显式声明依赖任务且加"dependsOrder":"sequence"才能按序执行；依赖任务需在tasks.json中定义并有匹配label，npm脚本须单独定义为带label的任务才可被引用。
tasks.json 里 dependsOn 链必须显式声明，否则不会按序执行
VSCode 的 tasks.json 默认不保证任务执行顺序。哪怕你在数组里把 compile 写在最前、deploy 写在最后，VSCode 也不会自动串行——它只按 label 名字字典序或并行触发，除非你用 dependsOn 明确绑定依赖关系。
常见错误是以为“写在前面就先跑”，结果备份还没做，部署脚本就把旧二进制覆盖了；或者 clean 任务被漏掉，导致增量编译失效。
-
dependsOn值必须是字符串数组，哪怕只依赖一个任务也要写成["compile"]，不能写成"compile" - 依赖任务本身也得有
"group": "build"或明确的"problemMatcher"，否则 VSCode 可能跳过它 - 循环依赖会被静默忽略（比如 A → B → A），VSCode 不报错也不执行，调试时容易卡在“没反应”状态
Makefile 中 -MMD -MP 是头文件变更触发重编译的唯一可靠方式
改了 utils.h 却没重新编译 main.o？这不是 VSCode 的锅，而是 Makefile 没生成或没包含 .d 依赖文件。GNU make 默认只看 .c 文件时间戳，对 .h 完全无感。
必须在 Makefile 里启用 GCC 的依赖自动生成机制，否则任何“改头文件不重编”的问题都绕不开这一步。
-
CFLAGS += -MMD -MP：让gcc -c同时输出 .d 文件，并为每个头文件生成空目标防止缺失时报错 - 加一行
-include $(SRCS:.c=.d)：确保所有 .d 文件被 include 进来，make 才知道main.o其实还依赖utils.h - 不要用
$(wildcard *.d)替代$(SRCS:.c=.d)：前者在源文件删减后残留旧 .d，会导致错误依赖
跨平台路径和 shell 命令写法必须收敛到 POSIX 兼容子集
Windows 上用 cp 和 $(date +%Y%m%d) 会直接失败，macOS 上用 del 或 %DATE% 同样挂掉。VSCode 的 tasks.json 本质是调用系统 shell，不是抽象层。
想一套配置通吃 Windows/macOS/Linux，就得放弃 cmd/batch 特有语法，只用 GNU 工具链通用写法。
- 复制用
cp而非copy，删除用rm -f而非del，日期用$(shell date +\%Y\%m\%d)（注意反斜杠转义） - 路径一律用正斜杠
/，VSCode 内部会自动适配 Windows 的反斜杠，但硬写\在 macOS/Linux 下会出错 - 避免
echo %PATH%这类 Windows-only 写法；改用echo "$PATH"，所有 POSIX shell（bash/zsh/dash）都认
Makefile 的 .PHONY 目标不声明，会导致同名文件阻塞任务执行
如果你写了 clean: 规则，又不小心在项目根目录下生成了一个叫 clean 的空文件，那么 make clean 就永远不会再运行——make 会认为“目标已最新”，直接跳过。
这是 Makefile 最隐蔽也最常踩的坑，尤其当项目里有自动生成文件（如 version.h）、日志或临时产物时。
- 所有不产出真实文件的目标（
clean、format、test、deploy）必须前置声明为.PHONY: clean format test deploy -
.PHONY后面的列表不能换行缩进，必须顶格写，否则 make 解析失败 - VSCode 的 Ctrl+Shift+B 默认调用
make，如果没设.PHONY，它可能静默失败而不报错
dependsOn 编排，硬塞进 Makefile 反而降低可读性和调试效率。 
