VSCode调试断点变空心圆主因是环境PATH、tasks.json配置、launch.json路径三者未对齐；需确保make/gcc可用、Makefile命名正确、tasks.json含group/isDefault/problemMatcher、launch.json的program路径与Makefile输出完全一致且含-g编译。
VSCode 本身不解析 Makefile，只调用系统 make 命令；编译失败或调试断点变空心圆，90% 是环境 PATH、tasks.json 配置、launch.json 路径三者没对齐。
Ctrl+Shift+B 按下没反应？先查 make 是否真可用
VSCode 启动时不会自动继承 shell 的 PATH，尤其 macOS/Linux 双击图标打开时，~/.zshrc 或 ~/.bash_profile 里的路径全失效。Windows 上则常因 mingw32-make.exe 没进系统 PATH 导致失败。
- 在 VSCode 底部集成终端里直接运行
make --version和gcc --version，必须有输出；没有就别配tasks.json了 - macOS/Linux 用户：关掉 VSCode，从终端执行
code .打开项目（确保已运行Shell Command: Install 'code' command in PATH） - Windows 用户：确认
mingw64\bin\make.exe或mingw32-make.exe在系统 PATH 中，且终端类型（terminal.integrated.defaultProfile.windows）设为 Command Prompt 或 PowerShell，别混用 Git Bash - 检查项目根目录下文件名是否严格为
Makefile（大小写敏感），不是makefile或GNUmakefile
tasks.json 必须配准这三项才能让构建生效
tasks.json 不是写脚本的地方，它是告诉 VSCode：“用什么命令调 make，传哪些参数，错误怎么解析”。漏一个，Ctrl+Shift+B 就白按，错误也跳不到源码行。
-
"command"固定为"make"（Linux/macOS）或"mingw32-make.exe"（Windows MinGW），别写绝对路径——换机器就挂 -
"args"放参数，不是拼在"command"里；例如想执行make -j4 debug，就写["-j4", "debug"] - 必须同时含
"group": "build"和"isDefault": true，否则快捷键不触发 - 必须配
"problemMatcher": ["$gcc"]，否则编译报错只显示红字，点不了、跳不到.c行 - 如果
Makefile在子目录（如src/Makefile），加"options": {"cwd": "${workspaceFolder}/src"}
launch.json 的 program 路径必须和 Makefile 输出完全一致
VSCode 调试器（GDB/LLDB）只认二进制文件，完全不读 Makefile。路径差一个字符、后缀少个 .exe，就会报 Cannot find executable file 或断点变空心圆。
- 看
Makefile里gcc -o或$(CC) -o后面写的路径，比如./build/app，那launch.json的"program"就得写成"${workspaceFolder}/build/app"（Linux/macOS）或"${workspaceFolder}/build/app.exe"（Windows） -
Makefile的CFLAGS或CXXFLAGS里必须含-g，且不能被-O2等优化覆盖；strip 过的可执行文件无法调试 -
"preLaunchTask"字符串必须和tasks.json中对应任务的"label"一字不差（大小写、空格、标点都算） - 改完
Makefile后，手动跑一次make clean && make all，确认可执行文件确实更新了——别信配置，信文件时间戳
最容易被忽略的是：Makefile 里 -g 和优化标志的顺序、program 路径中斜杠方向（Windows 下用正斜杠 / 更稳妥）、以及双击图标启动 VSCode 时 PATH 彻底丢失这件事——它不报错，只是静默失效。
