vscode不能直接运行pascal程序，必须本地安装fpc编译器并正确配置tasks.json（含-g和-o-参数）与launch.json（匹配输出名及调试器），且每次修改后需重载窗口。
VSCode 不能直接运行 Pascal 程序——它必须调用你本地安装的 fpc 编译器，且 tasks.json 和 launch.json 配置稍有偏差，就会编译失败、无法调试，或点“运行”后终端一闪而过。
fpc 命令在 VSCode 终端里必须能直接执行
这是所有后续配置生效的前提。VSCode 不会帮你找编译器，它只认系统 PATH 里的 fpc。
- 打开 VSCode 内置终端（
Ctrl+`），运行fpc -i；如果返回类似FPC 3.2.2的版本信息，说明已就位 - 若提示
command not found，别急着改tasks.json：Windows 用户检查安装时是否勾选了“Add to PATH”，macOS 用户确认/usr/local/bin/fpc是否存在，Linux 用户用sudo apt install fp-compiler即可 - 改完 PATH 后，务必新开一个 VSCode 窗口（不是重启编辑器，是关掉再重开），否则终端仍读不到新环境
tasks.json 必须带 -g 和 -O- 才能调试
只写 fpc ${file} 能编译出可执行文件，但没法设断点、变量显示为 <optimized out></optimized>——因为缺调试符号，且优化把变量干掉了。
-
args字段顺序不重要，但必须同时包含"-g"（生成 DWARF 符号）和"-O-"（关闭所有优化），例如：["-g", "-O-", "${file}"] -
type必须是"shell"，不是"process"；后者在 macOS/Linux 上常因路径解析失败静默退出 -
label值（比如"build"）要记牢——后面launch.json的preLaunchTask必须与之**完全一致**，包括大小写和空格 - 加个
"-v"参数能输出详细编译路径，出错时一眼看出是哪个单元没找到
launch.json 的 program 必须匹配实际生成的文件名
Free Pascal 默认输出 hello（macOS/Linux）或 hello.exe（Windows），VSCode 不会自动补后缀，写错就报 Cannot launch program 或直接卡在启动界面。
- 确认
tasks.json编译后生成的文件名，然后在launch.json中写死完整路径，例如："program": "./hello"或"program": "./hello.exe" - macOS 推荐用
CodeLLDB扩展，miDebuggerPath设为/usr/bin/lldb；Windows 用cpptools调试器时，miDebuggerPath指向gdb.exe（通常随 FPC 安装） -
sourceFileMap或sourceMap要配对，常见写法：{"./": "./"}，否则断点点击位置和实际停靠行不一致 - 路径里含中文或空格？哪怕只是项目文件夹名字带空格，
gdb加载也会失败且无明确报错——换纯英文路径最省事
最容易被忽略的是：每次改完 tasks.json 或 launch.json，都得手动按 Ctrl+Shift+P → Tasks: Run Task 先跑一次编译，确认终端真能成功输出 Compilation succeeded；如果这步都失败，调试器根本不会启动。
