vscode需将fpc.exe所在目录（如c:\fpc\3.2.2\bin\i386-win32）添加至系统path环境变量，再通过fpc -i验证；tasks.json中必须含-g和-o-参数以生成有效调试信息，否则调试失败。
VSCode 本身不内置 Pascal 支持，必须手动配置编译器路径、任务和调试器；不配 fpc.exe 路径或漏写 -g 参数，调试会直接失败。
怎么让 VSCode 找到 Free Pascal 编译器（fpc.exe）？
核心是把 fpc.exe 所在目录加进系统 PATH，否则 VSCode 的 tasks.json 里写绝对路径也容易出错（比如路径含空格或中文）。
- 先确认已安装 Free Pascal（如 FPC 3.2.2），并能找到
fpc.exe—— 常见路径如C:\FPC\3.2.2\bin\i386-win32\fpc.exe或C:\lazarus\fpc\3.2.2\bin\x86_64-win64\fpc.exe - 右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”中找到
Path，点击“编辑”→“新建”，粘贴fpc.exe所在的完整目录（只到bin这一级，不要带fpc.exe） - 打开新终端（cmd 或 PowerShell），运行
fpc -i，能输出版本信息才算生效；如果提示“不是内部或外部命令”，说明路径没加对或没重启终端
tasks.json 中哪些参数影响调试成败？
VSCode 编译任务（tasks.json）不只是为了生成 .exe，更是为调试器（gdb）准备带符号信息的可执行文件。关键就两个：是否启用调试信息、是否禁用优化。
-
"args"必须包含-g：这是让fpc输出 DWARF 调试符号的开关，缺了它，gdb启动后无法设断点、看不到变量值 - 必须加
-O-（大写字母 O 后跟短横）：关闭所有优化。否则函数内联、变量寄存器化会导致单步跳变、局部变量显示为<optimized out></optimized> - 建议加上
-v：编译时打印详细路径和单元依赖，出错时能快速定位是哪个.pas文件报错 - 不要用
-B（强制重建）代替-O-：它解决的是增量编译问题，和调试无关
为什么 launch.json 里 preLaunchTask 总是不触发？
这个字段不是“名字匹配就行”，它严格依赖 tasks.json 中 label 字段的**完全一致字符串**，且大小写敏感、空格也不能多一个。
-
launch.json中写的是"preLaunchTask": "compile"，那tasks.json里对应 task 的"label"就必须是"compile"，不能是"Compile"、"build"或"fpc-compile" - 如果改过
label，务必重启 VSCode —— 它不会热重载 task 定义 - 调试前按
Ctrl+Shift+P输入Tasks: Run Task，手动选一次该 task，看终端是否真能跑通编译；如果手动都失败，preLaunchTask肯定不执行 - 注意
type: "gdb"配置下，target字段必须指向最终生成的.exe，且路径中不能有中文或空格，否则gdb加载失败但错误提示极不明显
调试时变量显示 <optimized out></optimized> 或断点变灰怎么办？
这不是 VSCode 或插件的问题，而是 fpc 编译产物本身没提供足够调试信息，或者 gdb 没正确加载符号。
- 立刻检查
tasks.json是否漏了-g和-O-：这是 95% 以上同类问题的根因 - 编译后去项目目录看生成的
.exe文件大小——带调试信息的通常比不带的大 30% 以上；如果大小几乎一样，大概率参数没生效 - 在
launch.json的configurations里加一行："miDebuggerPath": "gdb.exe"，并确保系统 PATH 中有 MinGW 或 MSYS2 自带的gdb.exe（FPC 自带的gdb兼容性较差） - 如果用 Lazarus 附带的 FPC，注意其
gdb可能被精简过，建议单独装 MSYS2 +pacman -S mingw-w64-x86_64-gdb
最常被忽略的一点：Free Pascal 的调试支持严重依赖 -g 和 -O- 的组合，少一个，VSCode 就只能当普通文本编辑器用——界面再漂亮，也进不了调试器的门。
